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Revolution 2.0:the English like language 

designed around the way you think. 1 

Develop and deliver on 14 platforms, including Mac OS X, Windows and Linux. 

Now with support for XML, additional SQL databases, video capture, Unicode, Reports, 
enhanced faceless CGI applications, and more, The brand new Jaguar friendly user interface 
makes development simple. The new Cookbook of examples iets you get started fast. 
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C-TREE^ SERVER SDK 



Today’s database demands are often too complex for traditional database servers 
The functionality and precise level of control you need is simply not available. 
Perhaps you need alternate soil criteria for your data or a sj>ecial twist in the 
threading or communication logic. 


linhiuice our server with your own 
custom server-side functionality 

Move fuiictionality from the clicnl-sidc to 
the server-side to reduce network iral’llc 
and increase perfonriiuice 

Modify or replace entire server 
subsystems 

Complete source for the server 
mainline, key server 
subsysicnis, and client-side 

flexible ORM licensing 


FairCom’s c-lree'"^ Server SDK allows you to create a customized, 
indusinal-strengtli server designed for your particular needs. Use 
FairConTs kernel, with over 20 years of proven stability, or override 
functionality within specific subsystems to implement your own 
subtleties. Move your application's data L/C) functions lo ihe 
server-side to decrease network traffic and increase 
performance] 

FaiiCom's c-tree Server SDK is used by companies 
worldwide such as Software AG and Citibank\ It’s 
integrated seamlessly into c-tree Plus and includes 
complete source code to the server mainline and all the 
interface subsystems to the c-tree Sender, And 
best of all, once ytiu’ve created your unique, 
customized server, it is easy to install and 
administer: no DBA required! 


Visit www.faircom.ccMTi/ep/fTit/sdk today to take control of your server! 
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MAC OS X 


HELPING FILEMAKER PRO CUSTOl 

SCALE TO NEW HEIGHTS 




Sybase is’helping today's 
leading companies achleVofe 
Informatron Liquidity: a 
profitable state where ail of 
your information is transformed 
into real economic value. 


Want to enhance the performance 
of FileMaker Pro on MAC OS X? 
The same database engine that 
runs Wall Street can help you do 
just that. 


ASE 12.B increases the reliability, 
availability and scalability of 
your FileMaker Pro application. 
It provides better data integrity, 
world-class security and the 
ability to handle thousands of 
transactions per niinutellf II 
also give your users the power 

.cm ■ 

of SQL queries. 


A FREE Developer's Edition 
download is available online 
at sybase.com/filemaken 


A5E 12.5 for MAC OS X is yet 
one more example of how 
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GETTING 

STARTED 


Copyright 2003 by Daw Mark 


Getting Started: 
TinyViewer 


When I first .started prognttnming the Mat\ In those many 
yciirs ago, one of the earliest programs I wrtjte was a teeny app 
called Piet Viewer. PiclViewer put up a stanitmJ document 
window, with scroll bars and a grow tx)x, and tlrew a pici image, 
eenlereti in the window, 'llie first version just displayed the image, 
cli()ping it u> the window FrameRen as needed, The scroll Irars 
were mere decoration. When I tackled a more advanced version 
of Fki Viewer, I added the Ciillliack routines and other axle to 
bring ilic scroll kirs to life. In still a later incarnation, I added the 
ability to tirag and drop an image on a PiaViewer window. 

As 1 was pmtirtg the finishing touchers on this project, 1 
remeiniKT thinking, “gee, It sure would lx- nice if all this was jusi 
a bit easier.’' Framewtjrks likt* PtwerPlant dizi go a long way 
towards stringing all the pieces together, hui there was still a lot 
ol' hantUcroding to be done and lots of room for error. 

As you’ll see in this month's program, TinyViewer, the 
combination of the Ohjective-C niniime and rtKils like Interlace 
Btiiitler and Project Builder take working with ol>jecis to the 
next level. 

GFTTFR.S, StnTi£R.S, AND KeY VaLUE OIDING 

Before we dig into 'rinyViewer, I'd like to lake a iiiomenL to 
emphasize a |K)inl I made in my March column, d'he issue was 
a naming convention For accessor functions. 1 suggested that ym 
name your getter metliods to match the name of the instance 
variable Ixing retrieved, then put the word “set" in front of that 
(Ix^ sure to alp the first letter after the w^ortl "set") to name the 
setter funcLion. Here's the example 1 gave: 

• (int) hei ght ‘ // Reiums tin- rilut of ihc hdjtla fidd 

• (void) ght : (1 n t) h j // Sius the lieijilit Ikkl tii 

// the rjiue in ll 

Bill Cheeseman, famtms ex-atlomey (rememlxr the John 
Travolta movie A Civil Aaiotii Bruce Norris [dayetl Bill in the 
movie. Taie.) and (xxm aficionado (I highly reLxantiiend his 
most excellent bo<7k, CiKm Reci/ws far Mac OSX: Ibe Vermonl 
Uecijm), took the time to discuses the iinpoiiance of this 
ctmvenlion waih me. 


In a nutshell, consider this naming convention mandatory, 
not optional In Bills words: 

“The -height and -setHeighli getter and setter naming 
conventions are exfK'clad hy Jiiany Features of the AppKit 
and Foundation. While these are txpiional naming 
"conventions" From the jx^rspective of Objective^I as a 
language, they are effectively mandatory if you want to 
use the Ctxoa frameworks. You will kise a lot of 
imptJriant Coctxi framework fundionality if you don't 
follow^ these naming conventions. 

'Ihe most im|X>rtant aspect of the ('tjcoa frameworks 
iliai depends on following these naming conventions is 
the key-value a>ding protocol. Look up key-value 
codiug in die Cocoa dt>rLmientali<m, and read the class 
reference document for the NSKeyValueCcxltng informal 
protcjcol in the Foundation frameworks. Several 
important Oxoa techmtlogies use key-value coding, 
such as AppleScript. If you don't follow this naming 
convention for your accessors, you will not l>c able to 
take advantage of Cocoa's automatic support for 
AppleScriplability. There are several other areas where 
siniilar dependence on key-value coding recjuires you to 
fijilow these naming conventions. 

Basically, key-value coding leLs you write ctxle tliai calls 
methods l)y giving the names of instance variables as 
strings. This enal>les you to write a .single method which 
will oil other medKxls i>ascd on the strings you provide, 
rather than having to make actual method calls Cer, “to 
sent! aclual messages") in a long case statement. Because 
of this, the aciual method calls (“messages") can lx? 
detemiined at nm time, not hard-coded at compile time, 
Ftirlhemiore, key-value coding gives tfie separate, addtxl 
Ixmefit of providing the data in the correct type without 
your having to code tyjx: ctsercions in a case statement," 

Thanks, Bill! As you develop more confidence wiili 
Objective-C and Cticoa, spend some lime digging through the 


Dave Mark is a kmg-iiuie Mac developer and autlxjr anti has written a mitnber of Ixxiks on Macintosh developrnerii, indiiding Ijearri C on the 
Mtuirilo^b, Leam C'++ on the Mueiniosb, arul The Muantosh Pmgmmfning Primer series. Be sum to check out Dave's weh site at 
http://www.spiderworks.com. 
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key-value coding dcK and example's. Here*s a goud link to 
.start with: 

http://developer.3pple.eom/techpubsyniacosx/Cocoa/TasksAndConcep 

ts/ProgrammingTopics/KeyValueCoding/Concepts/basicprinciples^html 




OK, lei’s get back to this month's program.., 

TuvyView^ 

Every time 1 sit clown to tackle a new^ Mac progranmiing 
environmenl or mtitliotlology, 1 always seem to find mysetf corning 
back Lo PiclVicwer. I low am I going to get PiaViewer up and 
mtming with this new setup. As sexjo as T had my fit'st working 
version of Project Builder insialled, tlie first tiling I did w;is dig 
through I he Coexo ckx.*, kx jking foj' the clas.ses I'd need to ma.s!er lo 
create a resizable window, w'ith .scTollbirs, I a>uld uscio wliich I 
could display an iniitge, Onc:e 1 figuRd tlial out Td then tackle stime 
dnig-and<ln)p classes so 1 could add that feaaire to the prf>gnim. 

Little did I know how' easy (and cckjI) this would turn 
out to be. 

Create the TinyViewer Project 

Launch Project Builder and create a new project of type 
CociM Application. Name die app TinyVieti^r and save. In the 
Project Builder I'lies pane, click to open the triangle lo the left 
oT Resources, then open the triangle to the left of MahiMenu.nih. 
'itiis will reveal an item named EngUsh (assuming yr>i] are f^n an 
English-irased Mac). 

The .nib Hie is an Inierfijce Builder file. Interface Builder is 
sort of like ResEdit on steroids. Witli it, you can customize all 
your favorite objtxis and encode them for laier deciHimi\ when 
your program is actually mo. 'ITie item named English in tlie 
Project Builder Film tab refers lo die English-localized nil> file. 
Figure 1 shows die Finder listing of my version of UnyViewer. 
Notice the directory named FnglishJproj and the file 
MainMenu.nib within that directory. TliaPs the English version 
of tlie nil) file, die one well l?e working with in this column. 


• ae 


Ij Engles K.^mj 


M saR 


BiLk toriHMtd 

C++ Test«J 
Ci DarnivTcsitr 
vin|ilov«c 
j,* H*IJ& (terminal] 

HeliDiijc 
NSStrtfigTftkier 
\J Dt-empkirtt 
n TlnyVkCMVcr 


A 0 

Ap^iUcKiani DficumeiHi 
2 Aera. 


' ^1. $ build 

I' L- 


Lf English.Ipnjj 
maln.in 

h TmyVi«Aer.rtefix.h 
9- TiffvViiew«T,(ibptDjt 


_ bAr«l1t»t.4Uing4 
^ MdiInMenu.nili 


Figure /, Tbe EnglisbJproJ folder imide ibe project folder 


Figure 2 shows a Teniiinal listing sliowing a kxiilized 
applic*aLion on my liard drive. I start by going into \\\e/Ajpiicatums 
directory, the doing a cd into the .sub-directory CkMikiqp. If I 
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Getting organized just got easier 



• Intuitive outlining 

• Customizable notebook 
interface 

• Annotation with stickers, 
keywords. & highlighting 

• Dynamic indexing 

■ Super-Find searching 

• Drag-and-drop Page 
Bundles 


• Inter-application 
Clipping Services 

• Direct import from 
digital cameras 

' Rich image handling 

• Media Frames 

• Export to XML 

• Online help 
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looked at /Applications iii a l*indcr windt}w, (l{x:kapp would just 
appear as a single application tile, in rrality, your jyackaged 
aj>plicatic>n.s a series of tiles, all rolled under a single directoiy, 
in this case named Ciockapp. As Figure 2 shows, if you make 
your way down mio/ApplicaHotvs/Ck>ckMpp^CQntmls/, ysiuH .see a 
nunilKT of different files and directories, including a directory for 
each localized version of tlie aj)p. You slioLild dehnitely fire up 
Terminal and try tlus for yourself Dive down into your favorite 
af)]), then kxjk for Engtisb.pmj. 


% MainMenu.nib - MainMenu 

. ■ . - - — . .^ 

NewAppiication File Edit Window Help 

Figure 4. The defuult aj)})liculiim menuhar. 

'eee MainMenumrb 


Here's an excellent article by mmaleolm Crawford on Mac 
OS X kK:ali/aiion, well wt^rth the read: 

http://www.stepw]sexom/Article5/Technica!/2003-04'-03,0Thtml 


0 0 0 Teimtuftf — _ 

Lost Eogini norv Apr 7 UAtZliS an ^ 

tfalew to ftoTiurTl 

[Pnvid-llariia-Cci^iutBr;'^] diwiaiiarfcX eft /Aw hcotlcnt 
P>CiyEl}-Aarka-{:oap(A«r;/A()pHQDtii]ia| dovaanrtiji cd Citok^opp 
[(>CNl(MWt»-CPipUtoTVAppll0OiiafiVCI<iclE..m]J dcm«T4<;1l£ Ik ^ 

Cdntantft/ 

l(yMid-norkK.CDii«iiA«rVAponeaticAiyctoc^ dPvcfiptidE t<t Cemtertta 
(Davtii,4torks4:^3iiput«rVAppiicgttvi«/EEod4,4Wy^ dftfiftMrkJf la -F 

Into^plLKt fteOV Pitjglnrp RawutcKs/ v«r«lofi^Uit 

[tnvld 4 Vir 1 w 4 ;a 4 putof l/AppllcdtiDiiK/Ctocfc.i^ilVCiTitAitK) dovtnarkX Qd iWurpet 
[ppvi«Utarl;s-CoKpM«r:CtocR.app/tont«ntK/ftMaiK]n] ddvBKny.K ii -F 
ceda.ictie French, LpiTipj/ boEkiground.tlf pt.iproj/ 

ClOChBZ.tir G^aai.lpnij/ dD.lprpV Pf^lpripj/ 

Cl«kTltl«»tlFf ttotlan.tpfioj/ fi.tpro}/ I prpj/ 

Dutch, iproj/ Otvonew Jpnij/ lw,lproV ifuTVaproj/ 

EinpliihJmy Stflniah.tiWj/ no.lpioi/ 

[ODvid.^rvii^K-c«nptA4r:ciock.oiin/i:cni«rita^^ ddwaKirkKcd 

[0avtd-natKs4::iii^itil^:CanlafiLttj<1Ii«<^ doMDUrkX U -f 

C lochz Mbf Inf CPI i»t Liqx 

(ppv1{F-rlor1»-CMputer:Conltnto/neiaurr«K/^ lih. iproj] daveaaritv Ik -F Cioefc* 
ciBBHKJTib ipjro,nip objem.ntb 

[|Dmi<l~t1i]Klu-Cii^xitar:CantBntSw^^^ IpT&Jl dWtwrWI | 


f'igwre 2. Poiiow ibc iermitial comma mis to find your may to 
the loailizeci, nth files 


Editing the .nib File 

I)t)uble'ti \ck tm 7/;/ vVkmr/Ri^mfrci^MainAkmiLiti^^^^^^ 
in the project window Files tali. This will open your .nlh tile in 
Interface Builder. You’ll likely see 4 Interlace Builder w-incbws 
ap[)ear. 11 le window latxled Figure 3J represejits your 

app's main window. Ilie window lalieled MamMeiiUJiih - 
MainMcnn (Figure 4) contains your app’s menu bar. The window 
lalxTcxI MainMemtJiih (Figure 51 ads as a a^ntral re|K)sin>ry for 
the resources/insiances youH lx: crt^aiing. Ami I he window lalKTed 
Cfcotfi- (Figure 6) Is a ]7alette window. 

e : 0 Window 


Figure JL nedefauif TinyViemm wtfidow, shnoik 
for conmnience. 


I Instances 1^ Classes | images Sounds 



Rtri Qi nti I M a inMenu 


000 


Window 


A 

Fjgwre 5 Ihe main .nib j\k navigation mndbui 


0 0 Cotoj-Othcf o 



figure 6. the iKileltes ivindoiv. 


Note the r<7W of icons at the ro[7 of the palette window 
(Figure 6), CIi<’kEng on one of the icons changes tiie set of 
items available from that section of the paleiie. Currenily, there 
are 10 palette icons. In order, they are Menus, Views, Other, 
Windows, Data, Containers. Graph res lYerr'S, AppleScript, 
MSFFormatierPafeiie, and Sbetiock. Our focus will Ix^ on the 
tiurd icon from the left, the Otfyer [jaleitc. Click on the Other 
icon and ytujr palette window should look like tlie one shown 
in Figure 6. 

Click and drag an NSImageView out al Uie f>a(eiLe window 
into tfie window named Window. If you hover your CLirsor over 
an item in the paJeite window, a “ux>l tip” will appear that tells 
yc7U the item type. Drag the NSlmageView towards the upper-left 
c'orner of the WindotP window until a pair of crossed blue lines 
a[)pear (see Figure 7). 
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Figure 7- Dragging an NSImageVietv onto your main uHndow 

Ncxi, t:lic:k on ihe NSImageViett) icon ro select it. 8 grow 
handles will Drag die lower right grow handle to grow 

the NSJmageView until the crossed blue lines appear as you 
approach the lower right comer of the window, 'llie net result 
will be an NSImageVmi* inset in the window about the thickness 
of a scrollbar on al! four sides. 

Now, let's bring up an inspector window and customize our 
NSJmageView. Sclcci Show Info from the 7'ools menu, 'the 
NSImageVieuJ Info window will appear (Figure 8). The Info 
window allows you to modify the currently selected object. In 
this case, weVe inspecting our NS/mageVtew object. 
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i^rdcr 
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Figure 8. Ihe Infi} mmiowfor our NSImageVme. 

'lake a look at Figure 8. Your settings should kx>k like this. Be 
sure the editable checkbox b checked. Tliis will enable \lrag and 
drof)'’. In fuel, when you mke the interfac'e for a spin, try testing tlie 
interface witli and without the Fxiitahlc checklx)x checked. 

Next, select Size from the popup menu and compare your 
settings to those shown in Figure 9 Note that tlie Layoul Red 
fields will not necessarily match. Not to worry. It's just the 
difference between our window sizes. What's impoitanl is the 
Autosizing settings. 'I'o change those, click on the two lines in 
die inner stjuare tili each line turns into a pair of springs. Again, 
when you test the interface, play witli diese .settings. Try it with 
one line and one spring, just to see what alTect diis lias. 
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Figure 9. Ihe NSImageVieuf Info window, this time showing ihe 
Size seUings, 


Testing the Interface 

QK, now let's take the interface for a S[>in. Select Test 
Inierface from the File menu. Your window will appear, widi an 
NSInmgeView area centered in the window. Click on a picture 
and drag it to the NSImageView field. The image should apjxrar 
centered in the window^ When you resize the window, the 
image .should resize until ii reac:hes its tiiil size. 

Play, play, play. Drag tlie image back out of the window 
and onto the desktop. A clipping file should appear. Double¬ 
click it and you can view ytnir image directly in the Finder. Cool! 

7b exit the application, just select Quit Fmm the File menu. 

You should now lie back in Interface Builder. Select Save 
from the File menu to save the .nib file. Now go back into Project 
Builder and run TinyViewer. Notice that Tiny Viewer appears in 
the dock as an icon, the main tiienu is titled “TinyViewer", your 
window appears, and is fully fiinaional. Very cool!! 

lliereb a tenific new Cocoa lx)ok out dicre you should 
definitely check out. It's called Cocoa Programming by Scott 
Anguish, Erik M. Buuck, and Donald A, Yacklman, published by 
Sams. You can find it at hltp://wvvw.devdepot.com/bQoks.htmI. 

1 can't say enough about Cocoa Programming. Chapter 1 
has one of the cleare.st breakdowjis of the Mac OS X 
development univei-se Fve yet read. There's great coverage of 
Objective C, design patterns, memory management, strings, 
encoding/decoding, exhaustive coverage of the Cocoa 
frameworks, and just about anything else you might think of. 
And there, nestled in Cliapter 3 you II find the Cocoa 
Progmmnimg treatment of an NSImageView app. Great stuff, My 
liighest recommendation. 

TTll Next Month,.- 

Next month, well do more with Interface Btiilder, including 
exploring the details of die Info window and customizing the 
menu bar. See you then... 
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PROFESSrONAL SOFTWARE PROTECTION 


North America: 1-800-562-2543^ 847-818-3800 or HA5Rus@eAladdm.com international: +072-3-636-2222 or HASRii@eAladciin,com 
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* Susiness SE^hware Alliance Global Software Plrinry Studjf. Jum: ?005. Aladilhi Knowledge Systems actual hardw^Fa key statistics: 19BS-2D02 


Aladdin 

tCCVaiHC t>lt CLQtAl VIllAC? 


■ The widest range of licensing, module 
and networking models available. 


■ 24/7 hassle-free remote license upgrades 
and advanced HASP reporting tools. 


Plus, HASP4 is so easy to use, you'll 
wonder why you didn’t choose it before. 


Open your eyes to real anti-piracy 
protection. Call 1-800-562-2543 or visit 
HASP.com to request your FREE personal 
HASP4 Developer's Kit today. 


■ ■■■■ 

U ' 


Protecting your software and 
business revenue is simply a matter 
of choosing the right solution. 

HASP4’*' gives you tougher, more reliable 
software protection than any hardware 
key on the market. With HASP4, you get; 


■ Hardware-based string encryption— 
the strongest way to secure your software. 


■ A true cross-platform solution; 

1 key for 1 source code for Windows® 
Mac 0S*and Linux? 


■ 99.97% hardware success" in the field, 
backed by ISO 9001:2000 certification. 


■ A time-based licensing solution with 
a real-time internal clock—ideal for con¬ 
trolled beta testing, subscription, rental, 
pay-per-use or any time-based need. 


(B2003 Aladdin Knowledge Systent ltd. HA5P is a trademark Of Aladdift Knowledge Systems. Lid. 



















SECTION 7 


By Rich Morin 

XI 1 Tweaks 


making XI1 play nicely on the Mac 


Twtrakin|> Xll isn't for everyone. You'll Und yourself editing 
configuration files, niiriiniiging through voluminous FAQs and 
man pages, and whining piteously to folks on assorted niailing 
lists. Rven if you’re a dedicated liacker, you may begin to 
wonder whether this is the w'ay yovi want to spend your time. 

Mtjre to the point, you may not tiecxl to tweak XI h If, like 
many uscas, you only run commands by means of the XI1 
‘"Applications” menu, adding a few commands to the list may \y^ 
all you ever need to do. The syntax may be arcane, but ihe 
commands are short and the effects of a mistake are limited to 
tlie command involved. 

Cven if you want to run apps from llie command line, there 
are ways to avoid hacking. If you’re only running XI1 apps 
IcKTiily (i.e., on your desktop machine), you can start ihem up by 
means of Afjple’s open-xH command. This is an 
(imdcK’umented) XII analog to open(1), which starts up OSX 
apps. If you have XI1 running, you can start up a k>cal cofiy of 
xclock(1) by typing the following at any sfu:ll prompt; 

open xlI xclock 

In short, most XII tweaking is entirely optkmal, I would 
suggest, however, that you pul /usr/bin/X11 R6 intc? your PATH 
variable. TliLs will allow you read the XII man pages and run 
XI i apps wiiiioui the need for open-x11. 

If you’re a esht i) user, add die lollowiiig to your -/.login file: 

setenv PATH I PATH):/usr/XlIR&/b5n" 

If yuuVe a bash(1} user, add llie following to your 
$HOME/,bash_login file: 

PATH-*'? I PATH I :/usr/XllR6/bin" 

By some cute trickery, de,scrilx"d in manpath{1), the same 
infonnaiion is to set up manual page kxikups. Basically, if PAH I 
contains a bin directory, the corresptmding man directory is 
searched when man(1) is run. 

So much for XU tweaking, folks. That's it, all done, move 
along, nothing more to see liere... 


Still Herl? 

If you have more stringent requirements Cor imn't entranced 
with Apj)le’s "sUx'k” XU txmfiguradon), you may lx* inteix^tetl in 
hearing alx^ut some useful ‘Tweaks” fve run across* Even if you don’t 
share my simation or Ifs usehil to know how to aistomi^ XI h 

Until someone provides a GUI-based configuration lcK>k 
modifying XITs behavior will recjuire users k> edit text files, 
specifically, start-up setipts. Tile ‘‘system-wide” XU siart-up 
script is named /etc/Xtl/xinit/xinitrc; personal ones go in '-/.xinitre. 
Let's walk tlirougli the system version, so you'll know wdiich 
lines do what. 

If xinitre were a normal, exeaitable script, the first line would 
tell the system which interpreter (i.e.^ /bin/sh) to use on it, In fact, 
tilings are a hit weirder than that, /bin/sh is nominally the [lalh lo 
sh(1), the Bourne shell; like rmmy other vendors, however, Apple 
lias chosen to .substitute bash(1), the GNU Project’s Bourne-Again 
SHell, running in TTOIX" mode. Normally, this subsLttudon is 
invisible, but it’s nice to know what’s what. 

In Ihis particular case, however, tlie line is simply treated as 
a comment. Atifilc’s XU impicmcniaiion (like many others) 
always uses /bin/sh to inleqiret its start-up files, so dianging the 
requested interpreter wouldn’t make any difference at all! 

The first two characters (#!) of die script’s initial line, 
incidentally, are commonly pronounced **fK>und bang” or 
perhaps "‘shebang”. The second line is a comment which 
contains version intbrmaiion from rcs(1), ihe “revi.sion control 
system” that was used in maintaining this file. 

f! /bin/sh 

if $Id: Kinittc.v 1.2 2003/02/27 19:03:30 Jharper Kxp $ 

The next four lines define some shell variables, used to 
s[)edfy Ilk* locations. $HOME is an “environment variable"' w'hich 
is set at lt>gin time to tlie user’s liomc direcloiy* /etc is a 
traditional location for Unix control files; /etc/XII/xinit. 
f)rcdictahly, is an Xl bspedfic subdirectory for initial 17 . 11 1 ion hies, 

uscrTcaources^$ltUHli/ .Xriiiiources 
userinodniap^^llOME/ .Xmodin^p 
Ky^resources=/etc/Xl 1 /xinit/ . Krefiources 
sysmodmap^/etc /Xi 1 / xinit /. Xmodmap 

Next, the script checks for the existence of each file, 
exetTiiing a specific comtnand if the file is present. xmodmap(1} 


Kidi Morin has been irsing comjiJutei's since 1970, Unix sini'e 1985, :»al Mat-based Unix since 1986 (when he helpcxl Apple ert'ate A/UX l.U). When 
he isn i writing this n>lunin, Rit li runs Prime Time Freew'are (www.ptf.com), a publisher of books and CD ROMs for the Free and 0|xai Source stifiware 
coniiiiuriiiy. Fed Free (o w rite to Rich at rdm@ptf.C0m. 
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vs a alilily for modifying kuymaps and pf>inter button mappings; 
xrdb(1) is a resource database utility. 

# merge in defaults and keyiaaps 

tf i -f $syeresQurces 1; then 
xrdb -merge Ssycreeoureea 
fi 

If [ f $sysinodmap ]: then 
xmodnap $sy!>Riodtitap 
fl 

if I -f $ugerresources ]; then 
xrdh -merge Suserresources 
fi 

if [ f ^usermodrtinp ]: then 
X mod map $userntodmap 
fi 

With all of [he stftrings loitded, the server is in a ptxstiion to 
start up some prograiiLv First, it starts up an instil nee of xterm(1h 
a lenninat eEHulator. Hie ani|iersand at the end of the line forces 
the prognim to run in the background (rhat is, detached from the 
shell [>rtK‘css that is tnter|)rcting tills seri[)t). 

Finally, the siTipt starts quarlz-vvm(l), the Aqua Window 
Manager hir the X Winilow System on OS X. 'the exec command 
tells the current shell session to replace hself by the window 
manager (as opposed to waiting around for the wiiKlow 
manager to finish). Consequently^ any commands placed after 
the exec line will be ignored. 

If .“itarr somn nice progranifi 


fl fjtart the window manege*r 
exuc quartz-wtu 

Customization 

As dta'ussed in an earlier eoluiiin (“XI1: A C of Window 
Systems'*), XlTs goal is to provide ^mechanism, not polity*'. This 
makes it highly eusLomizal>le, but it also means that there are a 
great numlier of jK>ssible eon llgu rat ions, de[x:nding on eaeli 
user’s preferences and the methods chosen to achieve them. In 
short, don't expect MacinKxsh-siyle simplicity. 

Although the system-wide control files are imfxmani lo 
undeisfandj I'd reconinientl strongly against editing them. Apple 
is c|ulle likely to c hange one or more of these file.s in an update, 
so your changes might quietly disap[x:ar. Also, if liiere are any 
other users on your system, it might be considered bad fbnn to 
give them a "non-standard" configuration. 

Instead, CTCUle jx:rsonal control Hies (W.Xmodmap. 
-/.Xresoufces, and/or -/.xinitre), (f ymi only want to add or override 
some default settings, the first two of fhese may lie sufficient. Ihe 
start-up scriiX will use any sellings you put into your fxjrsonal files, 
iitter the system-wide .settings liave lieen loaded. 

To change Xlt's start-up liehavior, copy /etc/X11/xinit/xinitrc to 
-/.xinitre (lx.* sure lo include llie initial perkidl), then edit the copy. 
When the XIi server detects -/.xinitre, it wall use the personal 
script imtead of the .system-wide script, so be sure to include any 
lines (from the original script) that you want lo have run! 


itierin 



It's 3am on Sunday morning, 


Ifi THE fiERVER fiTILL RUNNING? 


L # The simple reiiability 

i f solution for Mac OS 9 and X 


End the 
worry with 


System-level Crash Detection jf 

patented hardware-software mtegfrat/on ^ 

* Automatic Crash Recovery ' * 

'* system restart or power cycle, as needed ^ 

•¥ Monitor Custom Applications 

, software developer's kit and plug-ins included 

* Scheduled Restarts 

cures memory leaks and fragmenfaf/on 

-f Restart after Power Failure 

even if shut down by your UPS 

* Comprehensive Error Logging 

to help you track down problems 

Simple Installation 

just plug in AC cord and USB cable 


For all these features plus six power 
outlets controllable by phone tones, 
schedules and scripts, consider 
our Poiver/fejr Pro S50 4dni/n. 


www.sophisticated.cgm 

/ SOPHISriCAlED CIRCUITS 


Copyright^PZQOZSophlsticBtsd Circuits, Inc. Kick-off i and PouvorKsyara registered tradoinarks 
of Sophisticated Circuits. Inc. Mac OS is a registered tradeniark ot Apple Cemputer, Inc. 






Rich's XI1 Tweaks 

Here is a personal set of tweaks, based on iiiy own situation 
and preferences, 'fhey won’t be die best diolce for every 
siniation, but they work well for me and show, in any case, how 
diis sort of thing can be done. 

My goal is to have a coasistendy Mac-like environment 
allowing me to edit files and run commands on bod: my desktop 
Mac (Cerberus) and a remote FreeBSI) box (cfcl). I should l>e 
able to run XI1 apps on either the desktop or remoie machine, 
by means of the command line or the XI1 server's 
“Applications” menu. 

Most users mil XI1 apps by means of the mouse, s<i let's 
look at setting up some entries in the Applications meniL 
Because XI I is a network-friendly window system, we can put 
in eitlier Icxral or remotely-executed commands: 

xplodk -title cerb^rus 

£tsh X tfrl xclock -title cfcl 

xLerm bg 'pink' geometry =80x60 


ilie first two coiuinands, al>ove, start up instances of 
xclock(1) on Cerberus and cfcl, respectively, ilie ""-title” option, 
descrilied in X(1), is used to indiaite which machine the app is 
amning on, 'Fhe last command sets up an 80 column by 60 line 
xterni(1}, using u garish pink hackgrriund cok>r (to distinguisli it 
from Terminal windows), 

'Ihe $PATH modifications described at the lieginning of ilie 
article let me look up XU commands and run diem from the 
cotiimand line. S|ieaking of command lines, however, let's set up 
Tenninal (yay!) as a substitute for xterm (feh!), 

Hie default xinitre file tells the Xi 1 server to .start up an 
xterm. Because ihi.s xterm doesn't have the desired chamcleristics 
(i.e., preset size and background color), 1 might a,s well get rid 
of it. So, I create a personal .stait-up file and then comment out 
the offending line: 

# xtern] ^ 

I could, if desired, start up some fiiimfK.T t)f xterm windows 
froni diis file, S|)ecifying tlieir sizes, ct>lors, initial positions, and 
many other attributes. Tm not going to do this, however, 
[>ecause I .sc'ldom warn to run xterm at all. The Tentiinal works 
jus! fine for me and xtemnis apfiearance and behavior areiVt 
even faintly Mac-like, .so wdiy ttse if? 

l.lnfortunately, this leaves me with a small pKjfilerii. XIl 
a]>plications use an environment variable (DISPLAY) to tell them 
where tliey should present fheir output (and get input such as 
keyboard and mou.se actions). Because the xterm alxwe was 
being started u|> by XI1, diis variable w^as Ixdng set for it 
automagically, I low can 1 get DISPLAY to lie set for Terminal? 

If I'm willing lo keep a copy of XI1 running all the time, 
there’s a really simple solution: nm Terminal from the XI t start¬ 
up scrij^t! As a “child” of XU, the Terminal process will inherit 
DISPLAY in exactly the same way that xterm (or any other app) 
would. Terminal goes into the background on its own, 
inddentally, so w^e don't need an ampersand: 

open /Applleations/Utllltles/Teriiiinal.app 


Obviously, XI1 depends heavily on the DISPLAY variable; if 
die variable gets trashed, bad things will start to happen. Worse, 
the cause of the problem may not [)c obvious. 8o, 1 wrote a 
siin|)le “sanity check”, which goes into the -/.login file on the 
remote machine: 

if [$?DISPLAy) xdpyinfg ) /dev/null 

xdpytnfo(l) is a utility for displaying information about an 
XI1 .server. If DISPLAY i.s set at login time, this program will lx? 
run. Aldiougli die nonnal output Ls discarded, 111 find out alxiut 
any DISPLAY problems from the program's eiTor messages, (In 
proper Unix fashion, these are output to .sfandartl error, which is 
nol di.scarded.) 


XI1 Forwarding 

ssh{1) is the modern replacement for telnet(l). It is secure, 
reliable, and has some veiy nifty features (one of which we’re 
alXHit to use When 1 log in to a remote machine, I want any 
XII commands 1 nm to display their windows on my desktop 
machine. This means I need a secure path for the XI1 protocol 
(and 1 don’t w'ant to wony much about how it’s done 

XI I forwartiing i.s the “silver buller that .solves Lhis 
problem. The ssh command (on the desktop machine) 
exchanges some infoniiatlon with ,sslid(8), tlie daemon proc^ess 
on the remote machine. When they're done, there’s a .secure 
communic“ation path Ibr iny .se.ssion! 

Hiere are two ways to ask for XU forwarding. Adding the “-X” 
apikm to the ssh cTanmand line is the simplest, bur it only affeas a 
single .session. If you want all of your ,s.sh ses.sions to do forwaaling, 
you can add die foUtiwing line to die end of /etc/ssh_config, but 
mmemher that an ujxlate may overwrite the file: 

ForwardXn yes 

I decided, instead, to create an alias (in -/.eshre) that sets up 
XI l-fbrwarded ssh .se.sston.s on cfcl: 

alias cfcl 'ssh -X cfcl' 


In any cuse, I can now start up Xl 1 (with no annoying xterm 
window showing up) and type commands into convenient, Mac- 
friendly Terminal window,s. Using the “-title" option, descTibed in 
X(1), I can even identify the machine an app is running on: 

rdiii@cerberus [**] I: xclock -title cetberus £< 
rdm@cerberus W\ 2t cfcl 

rdmecfcl ["] 1: xclock -titlG cfcl ^ 


Ttie result, a.s si town in the figure, is a pair ol clocks. One 
is running on cerherus (my Mac 08 X desktop machine); the 





^.3 


Other is running on cfcl 
(the FreeBSD Ixix 
downstaiis). Both show up 
on my desktop, however, 
proving Lliat I got 
everything right (except 
keeping the system docks 
synchronized :-). 
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ANtnuEK Approach 

One objection to this approiicli is that it requires live XI1 
server to run all the time* 1 don'i use Xll all that much, so this 
seems a [)it lieavy-hantleti. On the other hand, it Ls lx)th simpler 
and safer than the method I'm alxxut to descnln:. In short, 
proc'eed further at your own risk.,- 

There are many ways to set environment variables. If you 
add the following line to your -“/.login file, it will run for each 
new Terminal window: 

if {! $7I>ISPLAy) setenv CISPUY ViC' 

This code is a l>it subtle, so an explanation may l>e iti order. 
If DISPLAY is already set (as it wouki l>e if we were coming in 
from an xterm), we don't want to destroy the existing setting. 
Otherwi.se, however, weVe free to set up die variable. 

N€>te: Some programs (e.g., GNU Emacs) take the existence 
of DISPLAY as a guarantee that an Xll server is available. If 
Emac’s tries to talk to a nonexistent server, predietably bad things 
will happen. Of course, you can unset the variable Ix^fore you 
start up Etnacs, but that may seem a bit kliidgy; 

I (unsGtonv DTSPI^AY: eniics Too) 

Don’t tell any reiil Xll enthusiasts that you’re setting 
DISPLAY, by the way, unless you’re ready for an extended lediirt! 
on how things are supposed to be done. For that matten lliis Ls a 
klunky and somewhat fragile hack, hut it works for me 

Rpsourci^ 

I'ti like to thank the piitient and helpful folks on Xll-users (the 
Xll for Mac OS X discussion list) for helping me find the 
infonnation for this ankle. If you’re planning to use Xll on OSX, 
be sure to join this list (http://lists.apptecom/inailman/listinfo/xl1 -users). 

rd also rcajiiirncnd that you familiarize yourself with 
Apple’s ’‘Xll Public beta FAQ", the “Xll: Freciucmly Asked 
Questions’* thread on 11ie MacOSXliints Forums, and the “Xll 
for OS X Unofficial FAQ": 

hTtp://developet.apple.com/qa/qa 2001 /qa 1232.htnil 
http://forums.m3cosxhinticom/showthread.php?s=&threadid=8704 
htlp://www.misplaced.net/fom/Xl 1 

Even If you're nor planning to do Xll development, you 
sliDuld grab a copy of Apple’s “Xll for Mac OS X Public Beta 
SDK”. Most XII packages are distributed in source Ibnii; if you 
want t(j build them, yotfll need the SDK! 

Speaking of XI1 (and other) packages f()r OSX, Fink is a 
popular and frequently recommended source for prc-coinptled 
binaries, etc: 

http://fink.sourceforge.net 
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NETWORK 

MANAGEMENT 


By John C. Welch 
Edited hy Rachel Burdick 


Zeroconf 


A Rendezvous by any other name still 
works as easily 

WlI-COME 

Zeroconf is £he ,s[and;irtl aggregation behind Apple's 
“kendezvous" network configuration srfieinc, 1 say 
regal ion because, as vve will see, there are a number of 
parts that make up Zeroconf^—all of them making their way 
through the Internet Engineering Task Force, (lETF}slan(Jards 
process. Zeroctmf is also lio|K'fully the end of a multi-year 
{|uesi to finally give TCIVIP the same ease of use that Mac 
users have had for years with the AppleTalk proKnol family. 
What is ironic about Zeroconf is tlutt it, like Appie'lalk, 
originated at Apple, To he more specific, Zeroconf was 
created by Stuart Chesliire, a “Wizard without Portfolio” at 
Apple, I was at the Apple Worldwide Developer's 
Conference, CWWDC) in 2001 when Stuart first brought up 
the idea and he did it in the ni(>st understated way you can 
imagine—starting off with *" 80 , Fve had this idea, and I was 
w'ondering if anyone would he interested in it../ When he 
finished we w'ere amazed and astounded at leaving ju.si heart! 
a sokttitm to ninety percent of tnir prohlems with TCIVIP 
configttralion almost handed to us. It's not t>ften that you get 
to be in a place w'here brilliance happens, but this was one 
of those limes. 

Now; a I this fxanl there* are many [leople working on 
ZcTt)coiif, lull the seminal ideas and most of the methods lu-iiintl 
Zeroconf came from Stuart. St), the next time you are using the 
Rendezvous features in i(^hal or the upn>ming Rendezvous 
capabilities we saw democui in iTunes hy Steve jobs at MacWorid 
Expo of 21)02 in New York, siiy a hit of thanks to Stuart for 
making TCIVII* rinally work the way it should for the end ii.ser. 

ZiiRocoNr Principles 
lliere are three major elements of ZenK'onf: 


Address assignment/configiiration—or making sure that each 
device can get an ll^ address that is unicjue and usable 
wiihoui needing manual entry or external .services 
Natne assignment and pairing host mimes with tlieir rc,spective IP 
addresses—again, without needing manual configuration or 
an external server 

Service discovery, which allows tlte end user tt) easily Itxate and 
use network .services such as primers, file .servers, iTunes play 
lists, iChat panicipants, etc. 

Now, you don't bam* to use all Zeroconf features at once. 
For example, if you have a cal>le/DSL router acting as a DItCP 
server, you t^an still cxjntinue to use it in a Zeroconl' environment. 
One of the requirements for Zemetmf is tliat ii intist mininiize its 
effect on exisiing networks—iti other wurIs, do no harm. It 
.siiould afsi) niinmuze its effect an existing applications, lliis is a 
bit more dii'ficult to mamige anti, in some cases, it's unavoidable 
due to the way some applications work. Finally, while it isn’t any 
more' inherently secure than any oilier TCP/IP v4 prottxol or set 
of proUxols, it is also designed not to 1 k" any less secure, and it 
manages to achieve this as well. i-uciHy, all f)f this is easy, since 
noihing in Ztmxxmf is very new\ Another thing to remenilTer is 
that simplicity and ease of use (not scnlahiljt>d are the primaty" 
goafs of Zeroconf. If Zeroconf entls up Ix-ing able to scale 
globally, greaP But if there has to 1 k' a chokr Ix^tween ease of 
u.se and scalalnlity, then scaiahility should t<i.se. 

Another point to rememlx-r is ihai while not all of tlic 
individual pn)tcx:ols in ZertK:onf are limited to a kx.al link (a 
local link Ixlng any set t>f TC^P/IP end nodes you can reach 
without a router), the broadcasts and link l.oc:al (Lf) mechanisms 
of Zerticonf must not reac:h across suhnels* As we will see, if 
those parts of Zenxonf were to lie routed acro.ss tnulttple links, 
w^elL.Vlt w'ould Ix" liad.” Finally, Zeroconf protocols mu.st not 
make a.sstimpfions alxnu the state of a network as, in a [>ure 
Zercxxmf environment, all asfxxls of the network including a 
node's TCP/IP address can change. 


John Welch <jwekh@ffiit,e{lu> is a Consultant with MTTs IS deparinx^rit, and the Chief Know4t-All for TackySiiirt. He has over fifteen yeais of experience 
at juaking ct>mpiitcrs work. John specializes in figuring out w'ays in which to make the Mac do wliat nobody thinks it can, showing that the Mac is 
the suixrior administrative platform, and teacliing others how 10 use U in InleR^siing, if soiiieiitnes friglitening ways. I le also does things tliat don't 
involve foni[>iitertry‘ on occasioji —of at least, thafs the minor. 
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2erck:onf Makfup 

As I said uiirlicr, there are ifiree basic parts to Zeroconf, 
which create the founclation for a functional, easy to use 
network. 1‘hey are: 

Address assignment 
Name assignment 
Service Disexwer 

These three ]-)ana apply to abnost any network setup 
s<'heme from iraditional TCP/IP Lo AppleTalk, You have to 
cstahlisii a unique low-level identifier, relate that to a higher- 
level identifier, and then find ways to use the things your 
network provides for you. Ntme of (his is new in principle, Inu 
what is new is ilie way Zertxonf adapts existing standards 
and/or ideas to get the work done in an easy fashion. 

TCP/IP Address Assigmmeni 

So, now we have a brand new device using Zeroconf 
protocols to get things done—say^ a spiffy new KiHz 
PjjwerlicKjk CA for example. (Yes, I have a ricfi irnaginatkin.) 
The fiiM thing we have to do is assign it an IP address. 
Normally this is done manually, or by talking to a DHCP or PPI* 
server But in a Zeroconf environment %ve don't luive external 
.servers and we don't want to have to deal with manual 
addressing. So, how do we get IP addres.ses assigned correctly 
and easily? Simple—u.se Unkdxical (IJJ addre.s.sing. 

IX addressing is not new. ll has l>ecn in use on the MacOS 
since Mac OS 8.5 and on the Windows side of the world since 
Windows 98. How'ever, it w^as only used if a f)HCP server 
t ouldn't be found. IPs simply a way lo assign TCP/II^ addresses 
without needing an external or manifal configuration 
mechanism. Zeroconf uses a specific subnet for its atidress 
assignment—^the 169.251/16 subnet. This is registered with ihe 
[iiternel Assigned Numbers Authority, (JANA) specifically for 
rCP/IPvl LL address assignment. (TCP/IPv6 already handles 
this. t>etaifs can lx* fount! in RFC 2462.) 

Unlike in prevkius impleineniations, under Zeroconf LL 
addressing is always available, even if other addressing 
met hods are ttsed. This may seem redundant, but think alxjut 
it lor a second: if yt>ii always I lave LL addressing available 
you can stilt function even if the DHCP server goes do’Am or 
you arc temporarily in a dilTerenily-addressed network. If LL 
addressing w^asn‘1 always available, then you would have to 
have a ‘‘Zeroennr configuration set up so you could function 
in tho.se situations, w hich would detract somewhat from ease 
(>f u.se. The good thing al>oiiL ZeroconPs LL is that k doesn't 
break if you use other configuration niethod.s concurrently, 
nor will it break other configuration methods by its 
concurreni use with them. 

Since LL addressing is critical to Zeroconf we should 
define it a bit. In essence, LL machines are any machines that 
can see one another without the use of any device that 
decrements the TTL count or niodiftes the IP header or 


payload. Tlic TTL, or 'lime To Live” is a hop limiter used by 
routers. If a packet has a TH of 10, it can only go through 
that many routers before the TTL is at 0 and the packet will 
be dropped by the next router. LL addressing is not routable, 
so if the TTL count on a LL packet gets changed, something 
is wrong. In addition, things like Network Address 
Translation, (NAT) or «>ther setups that modify the packet 
information are not used on an LL network (indeed, they can 
cause major problems), so any network behind a tlevice 
performing NAT or some other function should not he part 
of a LL network. Again, LL addresses are not routable, nor are 
they allowed for use on the public Internet, so you can't use 
a LL network to gel onto the InlerneL unless you liave a LL- 
aware device on the network acting as a router. Ll is used 
most often with Pthernet (most networks are Kthernet, so this 
follows), but it can be used with almost any IEEE 802 media 
that supports at least IMb/second bandwidth, and some form 
of the Address Resolution Protocol, (ARP). 

LL addressing is designed for a fairly small number of 
maciiincs even iliough the iheoreiieal upper limit is 65024 
hosts on a given LL network. Due to the way in which LL 
works, and other limitations, the practical upper-end of a LL 
network is around 1300 machines. One of liie reasons for this 
limitation is iliai I'CIVIP addresses in a LL network are not 
static, 'fhey are quite dynaniic and can change regularly, even 
if you are in the middle of a neiwork operation. Tliereforc, LL 
implementaiitms rnusi ex[)ect situations where conflicting 
addres.ses are assigned aJid handle them gracefully in a way 
that allows them lf> reassign addresses “on-tluslly." This lias lo 
occur during the entire time the device is using a LL network, 
nut juM when the device initially joins the network. Obviously, 
LL devices should not be configured manually or via DHCP, as 
these methotls are not designed to function in sucli a dynamic 
environmenl. If you have a LL address on a given interface, that 
doesn) have to be the only addfes,s a,ssigned to that interface. 
In fact, having a manual, or DHCP address in addition lo the 
LL address is considered a good thing. Having both means that 
if your Mac needs to talk to a strange printer ju.st long enough 
to print an envelope you dtm’L need to reconfigure your 
network setup to do so. As long as both devices support LL 
addressing you should he able to communicate easily. A host 
isn't required to have any specific numlxa- of addresses in a 
TCP/IP v4 environmenl, but if that host is going to function in 
a TCP/IP v6 environment, it mii.st be able to have multiple 
addresses on a single interface. (I do menrit>n 11^ v6 quite a bit 
here, mostly ixeause it already has tliese capabilities and 
because as we all move to IP v6, we are going to he in a 
mixed-mode environment for many years to c:omeJ 

So, how docs LL address seicclitjn wcjrk? It follows a fairly 
straightforward procedure that allows it to ensure that the 
address it is using isn't alreatly in use by another device: 

Select an address in the 169.254/16 range, via a pseudo-random 
generator. Any address bui the first and last 256 addresses are 
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avaiiable, as theses arc" reserved hy the IETF and lANA for 
fLittire LLse. However the |■atldQnl address is picked, the 
startin^^ point, or seed' should based on a unkjue 
characterisric such as the interface’s MAC address. If a seed 
sudi as tile sysieiti clock time is used, you could have a 
gixnip of inacliines all starting at otice, constantly trying to 
grafi the same addresses. If the developer of the ll 
impicnicnlation desires, they can cache the address that is 
eventually u,sed as a staiting |X)int for the next time address 
selection takes place. 

Once an address Ls selected tlic host must lest to see if the 
address is free, usually via ARP. Tlie host broadcasts an ARP 
request on the link to see if it can get the desired address. 
This ARP packel has the following spet:s: 

Sender hardware address field filled with the MAC address of the 
interface that is being configLired 
The sender I? addre.ss is ^ero-filled to avoid polluting ARP 
caches, in case the desired address is being used by another 
machine. This makes the packet an “ARP probe.” 
i he target hardware address is zero-filled and ignored 
Tlie target IP address is set to tlie desired address. Tills way, if 
the address isn’t Izeing used the packet will never \ye 
answered hy the target IP address. 

Wlicn the host is ready, it wails for a random lime l>etwcen ;^ero 
and two seconds, and sends four ARP probes at m^o-second 
intervals. ('I bis helps avoid a .surge of probe traffic if multiple 


machines come on at once.) 

If the host receives an ARP packet where the sender IP address 
contains the desired address, the ho.st a.ssumes the address is 
in use and lias lu start again with a dirierenl address. 
(Remember that the sender address in the ARP probe is 
blank,) The host shoiikt maintain a counter that tracks the 
number of limes it probes (or an address alrc'ady in use. If 
the counter gets too high—say, over ten—^the host has to 
slow down the rate at which it proix^s for new addresses. 

If seconds pas,s after ihe last profe has been sent without a 
reply that indicates the desired address is in u.se, the host can 
claim the desired address. 

I'he host Then ha.s to send mo ARP announcements two .sectmds 
apart that have Ixnii the sender and target IP address set to 
the newly claimed address to helyi prevent stale ARP caches. 

Address Defense 

Now, just ixicause the hast has claimed an address on an 
interface dex^sn’t tnerin it is Finished wath the proce.ss. It has to 
help witli collision detection for as long as it is on the link. If it 
receives an ARP packel or prolx’^ where the sender IP address is 
its own IP address and the MAC addre.ss is different from the 
host’s ccmf'igurcd interface, there are two pcxssible actions: 

riie host can elect to give up the address and reconfigure itself. 
The host can defend its address. To do this, it records die lime 
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the conflicting ARP packet was received, and broadcasts 
an ARP announcement using the IP address it is defending 
as tlic sender IP, and tlie MAC address of the interface 
using that IP address as the sender hardware addresses for 
that packet. 

This does not mean that the host can always keep that 
address. If it gets muUipie convicting addresses within ten 
seconds (on ELliemel), tlicn the host has to give up that 
atidress and reconfigure itself. In this way, you avoid liaving 
multiple hosts in an infinite address defense loop. Obviously, 
changing IP addresses can do l>ad things to applications, 
transfers, etc., but this .should be rare if all hosts are following 
the niles. In all of these case.s the ARP transmissions are 
broadcast, not unicast. 

Interfaces with Multiple Addri^ses 

In our modern networking wa)rld a given interface can, 
and often does have more than one IP address. Under 
Xeroconf this is quite common. If the destination addre.ss is 
in the LL suhnci, and the host is .sel up with a LL addre.s.s then 
ohviou.sly you just use that LL-configuied address to send llie 
packet out, If the host domfi have a IL address, it can use 
ARP to locate the h{)si with the LI address and send the 
packet, hut using its own routable address in the packet. The 
host can t send a packet with a IL destination address to a 
router. If both the de.stinafion and the host each have LLund 
routable addresses, the address Lised as the deslinatitm is vif) 
to the host, and should be based on wdiich address is likely 
lo be the most stable. 

It's important to note that LL packets are not ronial>le. The 
'n'L value of all LL packets must he set to 2S5 by the sender— 
that is the only valid value for the destination to use. (Routers 
decrement the TTL cveiy time they pass a packet, so a Tfl. of 
less than 255 indicates that routing happened.) Routers should 
not answer any LL ARP packets unless they are set tip with a 
LL interface. This restric tion applies to muliic asi packets on ihe 
I.L segment as well. It is i>erfeetly eonect to assume that any 
packets in the LL subnet are local and directly reachable, 
SubnetEing of a LL segment is to Ik- avokled, as it wall 
undermine the ARP coilision detection ineehanisuj. 

Muill-hotticd Hosts 

Another idiosyncrasy that can crop lEp involves multi¬ 
homed hosts. RememiKr that out of the lx)x, any Mac can have 
iw^o EiJicrnei inierface.s—one wired, one wireless. X.serve.s can 
have two wired (jigaljil KlherneE interlaces. If you take PCI .slots 
and multiport Ethernet cards into account, a G4 tower can have 
over 12 interfac:es. Evtm a l^rwerBook G4 can potentially have 
multiple interfaces, thanks to the PC Card slot. In our Zeroconf 
LL scenario, multi-homed liosts have three choices: 

Only use one interface lor LL traffic an<l defend the address on 
that interface alone 


Use interface identifiers and share the LI address across all active 
interfaces, tlie LL addres.s is cTeated once but defended on 
all active interfaces. 

Use each interface's IP address U? identify llie interface, 
along with additional properties to support the ID 
process. Each LL interface has iLs own un](]ue LL address 
and lias to defend that address, even against other 
interfaces on the same host. One thing the ho.st can do 
when bringing up a new interface is to internally probe 
the other interfaces and make sure not lo pick addresses 
that are assigned to those other interfaces, so the host 
doesn't have to ARP for them. ( ARP is a verb too, it stands 
for Address Resolution Proiocol) 

Another problem can crop up when you join two separate 
networks together via a bridge or otlier non-router nietlu)d, 
such a,s the connection of two previously separate hubs In a 
case like this, as address conVicts are detected, they get 
resolved just like any other conllici. In any event, hosts siiould 
not be sending out “just in case’' ARPs, as that can liecome a 
serioirs bandwidth waster. 

Security Considerations 

Since joining a network is far easier with LL addressing 
under Zeroconf, iheiv is the [KJlenlial here ftjr “bad” hosts to 
join the network and conduct attacks. ARP is not a secure 
protcKol at all, and should never lie a.ssumed to be such. 
Anyone paekep.snilTing on a Zeroconf network can easily get 
a list of MAC addresses that can he used for nefarious 
purposes, such as sending out ARP replies that allow it ro 
claim every addre.ss on ihe Li. segment, thereby (Tearing a 
DOS for that segment. 

However, LL isn't new and its increased use in Zeroconf 
does not make ir any less secure than ir already w'as. 

Miscellaneous Application Issues 

One side-effect of Zeroconf and LL Ls ihaf network 
address usage gets a lot more complex. A network 
application can nt> longer assume that the IP address at the 
Sian of a transaction will he the same at the end. Connecrion- 
dependent protocois, such as in'l^ wall have problems with 
this. .Security implementations that rely on TP address, such 
a.s Kerberos will need to be updated to handle this or just not 
used in a LL network. Anollier problem is that on a multi¬ 
homed host, if each interlace is connected to a different 
physical subnet, they could all have the same IP addres.s, yet 
not conflict with one another. In any event, many 
applications will have tc? I>e rewritlcai to handle this 
gracefully—and no, a dialog saying, “Your address changed, 
so 1 failed” doesn’t count. 

Hos^r Name Assignment 

Now that we have our 11^ address assigned w^e need to 
c'ome up with a name for our machine. Yes, you c-an wemk 
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with IP addressefi directly, but who wants to do that wltcn 
you can give your niadiine a liuman-readable name—maybe 
even one that is descriptive. There are a lot of ways u» do 
this, including the one we use every^ day that has been tested 
t>n a g!ol>al scale for decades now: the Domain Name 
System, or DNS, 

While DNS does this nicely, the traditional DNS 
impieinenUiUon (a.k,a. - Unicast DNS) is difficult For home 
networks, ad hoc networks or small networks. For one, it needs 
a dedicated server^ which an ad hoc network won't tend to liavc. 
For anolher, even with various tools it’s really hard to set up For 
the uninitiated, and even a minor misLake can caiLse you 
problems. Finally, having to set up a server ahead of time isn’t 
“ZcrtK'onr. Hui, DNS is well known and stable so we want to 
use it, but we don’t want to configure it. 'Hie answer is Multicast 
DNS, or inDNS. 

MDNS 

niDNS is a serverless LL impleinentatit>n of DNS's naming 
funait>n. h allows for aurotnaric naming of devices, without a 
server. It handles naming and conllict resolution For a Zertx-onf 
segment without the users having to know anything ahom DNS, 
It is enabled in Mac OSX 10.2 and later (iChai lx*ing the most 
ol)vious use here) and may show up in Windows XP in a future 
service pack. 

Like everything else in Zeroconb the idea is to make 
existing protocols and methtxlologie.s work in a mtire friendly 
fashion rather ilum recTciiiing the w^heel via some over- 
engineered, overly cxjmplicated im]>lemenLULUm that would get 
ignored. It is designed to create no more traffic tliun exists with 
ARP IjRjadcasLs today, as overburdening a network would again 
cause this not to ix" used. As with ll addressing, I lie niDNS 
domain—Joca!—is designed not to be routable along witli any 
sulKlomains of .hxal. as ihey w^ould have no meaning outside of 
the link on which they live. 

In an niDNS system, all mDNS requests go to 22^.0.0.251 
on each muchine in ihe Zeroconf segment. Also, any requests 
For a name in llie 25-i.169.iii-addr.arpa domain on the segment 
would go !o the mDNS address. As a domain, .pK^al ads like 
any oilier .search domain on a machine. Unqualified queries 
go to .local Inst (on Zeroconf tievices). For example, if you 
were looking For *rocking4’ it would first be searched for as 
Toeking^Joca]’. This doesn’t preclude the use of "normal” 
DNS names or using Iratlilkinal DNS seivers. For example, my 
Mac at work luis an MIT DNS name and a Rendezvous name. 
Both machine names are the same, but the MIT name ends in 
.mit.edu anti is a global DNS name, whereas the Rendezvous 
name ends in .local. In my case, I use mil.edu as my initial 
.search domain, then .local, but lx>lh coexist peacefully. So 
inDNS doesn’t ret|uire any more work on the part of the user 
than traditional DNS. 

However, if you are a home user, you don’t need to 
concern yourself. If you have ever set up machine names for 
AppleTalk netw-orks, that's the effort needed for mDNS names. 


Once youVe set up your machine name in the sharing control 
panel, you connect up to tlie LL segment. You gel your LL IP 
address, then Rendezvous send.s out mDNS queries to see if 
any other machine on the segment is using your ho.st name. If 
you are the first, or the only one using that namt^ you’re done 
and you hiive a host name, ff there is already a machine using 
that name, then just like AppleTalk, yf>u have to change your 
ho-stname. That's alwiul all that tlie work-al-home/ad hoc user 
ever needs to do. 

One of the concerns with this is name conflicts. As it turns 
out, Apple's long-time experience with automatic name 
ennhgurntion .shows that this isn’t much of a pn>hlem. There are 
human reasons for unique computer names that help smooth 
this out before the mac’hine ever gets on the network. Another 
problem that can arise is if a routed packet sliows up acting like 
a LL packet. Well, just as with l.L addres.sing, if the TTL value of 
the mDNS packet is less than 255, it is considered an invalid 
packet and is ignored. This avoids acceptance of errcmeously 
routed packets or packets from an outside fiost trying to sptK)f 
lite LL segmeni. 

Request Types 

Wiihin an mDN.S network there are three basic kinds of 
DNS requests that are gtjing to lx: seen. Hie first Ls a standard 
DNS request that would lx used i>y any device needing DNS 
servit^' from a normal imicast DNS setup. This kind of 
*'one-slioL" rcc|uesl/reply is ncxmally vised by devices that are 
not aware of mDNS (a.k.a. - '"luDNS-slupid”). While an mDNS- 
siupkl client can send a standard request lo ifie 224.0,0,251 
addirss, lliert* are some problems with it. for one, normally with 
a unicast DNS ax[uesl you lake the first valid answer you get 
back since you are only asking tine server at a lime. In an mDNS 
network, you are asking mDNS machine at once, and you 
may get back hundreds of replies. IF you only take the first one 
it has a good chance of being wrong. One-.shoi retjyests can alsti 
caiuse problems if the thing you are l(X)king for is not on die 
.Itxal domain, as then you ccmkl get false p<jsitives or incorrect 
“thing not fourur error messages. 

1’lie next kind of request is a ”one request out, [iiuitiple 
reply back" retjue.si, and is used by niDNS-aw'ure diems. Ihis is 
a dieni lliat urHierstands that there is a tlifference lietween 
mDNS and iinieist DNS and ads approjirialely. in this case, the 
client undcrstand.s that it is going to get juultiple responses and 
looks at all of the responses to 11 nd the right one. It will 
retran.smir the request until it finds what it is kxjking for or puLs 
up a ’'thing nt>t fount I" error. To increase efficiency and decrease 
network tralTic, die client can put more than one question into 
the question section of the rtxjuesi. 

Tlie final kind of request j.s a \'ontjnuous" request, as used 
l>y s<)niediing like a network or printer browser. Ibis is akin to 
leaving the Chtx)ser, or llte 'Conned to Server’ window open. 
This IS the kind of thing you’d do while testing a j>rimcr that 
should lx on die network, but isn’t, in order lo see when it 
comes back on the network. Obviously, tfiis kintl of request can 
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cTcaic problems if it nms for too lon^ or if multiple clients ;tre 
genentting them, which is wtiy an IP I'^njwser wmdow/app 
under ZertK'onf niusi nut generate overly large amtHtnis of 
traffic. One of the ways in which mDNS helps prevent this is via 
Duplicate Suppression. 

Duplicate Suppression 

When you have an ad lioc network with multiple nodes 
providing various services, one thing you want to avoid is lo 
have every single device having to respond every single time 
to every single request. One of tlie ways in which to avoid 
this is to use cacliing in die iiiDNS requests. When an mi)NS 
requesler sends a request with answers it already knows 
about, it po]>ulates the answer section of Lite DNS messages 
with those cached records. Tliose records have a iTL value 
that will remain valid for at least this request and the next 
two following requests, i'his way, you avoid iK>ih extra traffic 
and had information in the caelie. As the request hits the 
various mDNS resptmders on the segment, they all examine 
the request. If the cache contains the answer they would 
have given, and the cached TTL is at least half of the value 
of the real TTl., tliey don’t respond and we avt>id 
unnecessary traffic. If the Tli of the cached info (Yes, TTL is 
being used differently here. This is not the TTL used to check 
for erroneous routing, hut a different ITL used to prevent 
stale caches.) is less than half of the real TTL, Lite niDNS 
responder replies, so as to update ilie cache and prevent 
p re ma t u re ex piratic m . 

One thing that must be avoided is an mDNS requester 
caching resource records observed t>n other niDNS requests* 
This is l>ecause the answer section of those requests ts nol 
authoritative, or llie information is \o be cc^rrect, but 

not certified to l>e correct. Again, Zenxronf is a very dynamic 
environment , whic h means tliat a device in the answer 
section could have dropped off the network a milfisccond 
after updating the cache. Obviously an mDNS responder 
needs to allow for larger-sized requests and replies in 
accordance wttii the “Extension Mechanisms for DNS 
(EDNSO)", IETF RFC2671. By correctly implementing caching 
and duplicate suppression, a Zerocunf network gets the same 
kind of functionality fnmi mDNS that AppleTalk got from 
ZliVNBP, with less traffic. 

Responding 

So, we have an mDNS request that has come in—now we 
need lo handle responding to it. First <jff, failures aren’t 
something for responses. If no resjxjnse is received , fa I hi re is 
assumed. This avoids exiianc-ous uaffic from three hundred 
hosts all saying “not me" and one host saying “here you go," 
There's not much ptrini in doing all of that duplicate 
suppression w'ork on liie request side just to blow it away on 
ilie res|x>ase side. On an Ethernet-style network, the mDNS 
responder should delay iLs responses by a randoni perickl 
between zero and ten milliseconds. This is to avfitd collisions 
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on (lie network. If, however, the mDNS responder has verified 
lhal ii is ihe only device that can respond to a givt^n request, 
the delay is not needed. 

Just like unicast J)NS, iiiDNS responses go to UDP port 53. 
One ihing to remember here is that the in DNS re.sponder can’t 
make assumptions about the uniqueness of a name, since a 
XercK'onf network may constanlly be in flux. All mDNS peers 
must continually monitor the network to ensure that name 
collisions don't liappen. (f a response's source (Kirl isn't lIDP 
53, a client may nut lie aware that it is in a multicast 
environment and is just blindly responding. In this case, the 
niDNS responder must send a normal mDNS res()onse lo I he 
reque.ster's LIDP 53 f>ori ami an identical response to the 
reeptesrer’s source LIDI^ port and IP address. If a request has 
more than one c|uestion, the mDNS resjxmder musi respond 
to all t|uestions to which it can give a pt^sitive response. If tlie 
mfINS responder has unique recxirds for the .local domain, it 
has to also have an mDNS requester so that it can verify file 
uniqueness of its recortls. 

In a Zercxroiif nelw'ork—espex:iaily otic chock Hill of Mac 
OS X users—there are a lot of e*ve*nLs lia[i[)ening. Machines start- 
they wake up; they c-hange how they are connected lo tfie 
network. When any of itiese events (xcur, the mDNS resiK>nder 
has a few required tasks to ixTlbnn: 

Por any resource records ihai have lo he unique on ilie LL 
segment it has to send an mDNS query to see if any of 
lliem are in use (i.e. - by another device using that name 
for a host name). Since mDNS queries can have multiple 
responses, this can be done with a single packet. If any 
conflicts/collisions are found, the device alnxidy using that 
name wins. The ijueries are sent multiple times, with the 
second quer>' hap]>eniftg one second after the first, 'two 
secomis later the third query goes out, and so on, for 
seven seconds. 

'flu- mDNS re.sponder sliould then .senti out a gratuitous 
mDNS response, with the Answer section filled svith any 
resource records that could lx of use Kj other hosts on the 
link. I his could include PTR rectmls useil by DNS Service 
Di.scoveiy\ This allows ho,sts that liave open browser 
windows to lie itnmediately updated, so they ilon’i have (o 
send a recpiest of their owm, iherehy reducing network 
traffic. Up to ten (.if the.se gratuitous responses can he sent, 
Init the lime inleiTal between them must double with 
every' response sent. 

Iti atiy event, the (miy lime annoutieemems are to lx sent 
out gnituttuusly is w'lieii a I lost has a cliange event in its network 
connexion. There are lo he no |xriodtc "fley, I'm here and 
here's what I have.’' announcements. 

Conflict Resolution 

Witli mDNS, a conllici happens when you have multiple 
resource records that have the same namc/type/class 


ctmiaining inconsLstem rdata . If two hosts liavc identical 
rdata, it is not inconsistent rdata. However, if a host wants to 
have a given name and runs into a segment with that name 
in use by a different IP address, this i,s an example of 
inconsistent rdata. Whenever an niDNS responder receives a 
response with a conflict In a resource record, the responder 
must cease using that record and may have lo reconfigure 
itself to avoid tlie conflict* If the host in question is a device 
with a human user, the responder can pop a notification to 
the human so that the human can make ilic ciiange. Once the 
change is made, conflict testing must be repeated. With 
mDNS, the first host using a name is the one that wins all 
confltcis. With regard to conflict Lesling, it is again useful to 
note that .local and 254.l69.in-addr.arpu have only local 
significance. This is in contrast with "normaU DNvS, which is 
concerned with global uniqueness* Since mDNS is only 
working at a LI. level, conilicts between different LL segments 
are likely U) occur. 

iTiDNS Record Differences 

mDNS doesn't use NS records, as all mDNS domains are 
delegated to 224,0.0,25b Thai address i,s the "name server" 
for mDNS* Since it is a multicast host, thus address identifies 
a group of hosts working together to maintain the .Uxal 
zone, l-or any segment, inDNS works as a single zone run as 
a distributed name .server process. Since an mDNS zone i*s a 
loose collection of CPUs working together, there is no 
delegation in an mDNS zone. If a host is responding for a 
given record, there is no guarantee that it will respond for 
cliddren of that record, or even other re,source*s in that 
record. Another recortl nrn used by mDNS zones is tlie Start 
Of Autluxity, or SO A rec‘r>rd. Since there is no 
"udministnitor" in an mDNS zone iliere is ik> need fora SOA 
email address. Along that line, since there is only loose 
coordination between hosts in an mDNS zone^ there is no 
way in which to implement an increasing serial minilier. 
Another mDNS difference is that there are no zone transfers 
for any mDNS zone. 

mDNS Miscellany 

Clearly, mDNS is going to lx useful in a Service Discovery 
application, which well touch upon in detail in the DNS Service 
I)isce)very (DNS-S1)) st‘Ct ion. As we saw earller, the inf()rnialit>n 
caching in mDNS uses TYl. values to determine validity* Because 
a Zertx’onf network is not assumed to lx sial^le, these Til 
values should lx* mejisurecl in .seconds, so as to avoid stale 
information. If you arc* using DNS-SD, this can lx excepted for 
fairly stable devices like la.ser printers, eii., in order to avoid 
excessive neiwaxk tniffic. 

With regard to failover to mDNS for names outside of .Icxa), 
this should lx optional and clisal)led by tlefaiilt in order to avoid 
security issues that w'ould be caused by local resolution of global 
names. LtxAup options for unqualified names in .Itxal are 
('(mtroiled l>y the existence of *t<xal in the DNS search domain 
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list on an niDNS clicnU If a resource is working in a .local 
domain, but wants to avoid mDNS, it can do so by not iKsing any 
names ending in .local. 

If a ho.st is multidiomed, it needs to defend its fully 
qualified domain name fFQDN) on any and all active 
interfaces that are responding to niDNS requests. In the event 
of a conflict on any interface the host should configure a new 
host name. When answering an inDNS request, a multi¬ 
homed host with LL addresses should take care to check that 
addresses in an mONS reply are valid for the interface that is 
responding. If a host has multiple interfaces and it delects 
multiple hosts with the same name, but on different LL 
segments, it should understand that tills is valid. Obviously, 
mUNS clients need to listen for and examine all mDNS 
messages for useful information. The information can be 
cached or not, as desired, but if caching Ls used the Til 
aging issues must i)e handled correctly. 

niDNS Message Format Specifics 

Tlie query 11) should lx? set io zero on iransmi.ssitjn and ignored 
on reception. 'Iliis does not apply to unicast DNS cjueries, 
which have to honor the query ID. 

The query/responsc bit (QK) must be set to zero for queries, and 
one for respoases. 

Under cnirrent IFIT standards, the Opcode must be set to zero. 
The authorilalive answer (AA) bit must be set on a request to 
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zero on transmission and l>c ignored by the re<'eiver. Por a 
response message, this bit must l>e set to one. 

TIte recursion desired (RD) bit must i>e set to zero on 
transmission and ignored on reception. 

'He recursion available (RA) bit must l>e set to zero on 
transmission anci ignored f>n reception, 
llie zero bit (Z) bit inust be .set to zero on iransmission and 
ignored on reception. 

The auihenitc diiia CAD) hit must be set to zero on tmasmission 
and ignored on recepLkrn for ([iieries. li can be set to one on 
responses, but shoolcln'i trusted wiiliout the source ixing 
trusted, a seal re piith to the source, or DNS transaction 
security is used. 

'the checking disabled {CD) bit is set according to resolver 
policy for qtieries. Par response-s, the bit must lx* set to zero 
on traasmission and ignored on reception. 

I'he re.sponse code (RCX>l>E) bit must lx* zero on transmissit>ns, 
and any non-zero valties must lx ignored. 

IP v6 Considerations 

IP v6 and IP v4 ignore each other on the same host as 
though tliey were physically separate, Sf5 it is possible lo have 
two .kxal zxjnes on the same ho.si. If the ho.si has lx>th IF v4 and 
IP v6 in use (dual-stacked), U should register with both v4 and 
v6 .local zones so it can talk to v4 anti v6 hosts. 

Security Considerations 

If authenticity of information is critical rlien DNSSEC needs 
lo be used, especially if DNS cjueries outside of .local are sent 
to the all-DNS multicast addre.ss, a.s wiih network outages that 
kill a device's connection to tlic Internet. If DNSSEC is not use, 
you could have a rogue host masquerading as a local host. 
While a j>ropcT FQDN Inis a trailing dot cm the end, most 
people omit this. (You probably don't look for 
www.applexom.) Because of this omission, a rogue host could 
masqLierade as a host in a domain by ansvvering requests tliat 
do u.se the trailing dot. To avoid this, a hosi must not append 
“.IcKiaP to a relative domain name with two or mure labels. It 
is acceptable to append it to a relative domain mime with two 
or more labels, since the user should not cxfxct a single label 
domain name to work as4s. 

LANA Considerations 

lANA has allocated the IP v4 LL multicast address 
224.0.0.251 for mDNS use, 

DNS Si-RVici' Dlsc:ovlry 

So, now we have our IP address—our host name. What's 
next? We have lo find things to do, a.k.a. - Services. Since we 
have this "really nice mDNS thing*" running, our next step 
should be to use that to find things. One of the best service 
discovery (SD) protocols is still AppleTalk's ZIP/NBF 
combination. There have been nuiiieroos attempis to replicate 
this on TCP/IF networks like NLS and SIP, but they tend to 
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faii, mostly because they are ton complex in implementatifin 
and use and are so over-engineered as to make a simi)le 
implementation quite difficult, (SLP is indeed a robust, 
flexible SD protocol, hut I have yet to see an implementation 
that was even ciose lo l>eing as simple as setting up 
AppleTalk's SD protocols. Mostly because outside of ^ones, 
there really wasn’t any setup work for ZlP/NBP,) 

There are four basic properties of a gcx)d SD protocol 
(according to the DNS-SD folks, and yours truly): 

It has the ability to ciuery for a certain type of .service in a 
specified domain, and get o. list of tJie named instances of 
those services. In other words, “I want to see some printers 
in tiomain X. Okay, here's a list of printers for X. C(K)1, 
thanks."’ Keep the t]ucries and the responses simple. 

Once it is given the name of an instance of the desired service 
(i.e. “ Printer “4rh Flexor Color Xerox laser with duplexerD, 
resolve tlial name lo Llie information the client needs to use 
that inslarice for that service. So once the human picks the 
primer, the SD protocol has to be able to get ihe information 
needed so tliat printing can commence. 

The names need to be persistent (i.e. - a printer that is iJiere 
today, sliouki be there tomorrow, even if the information 
for that printer has changed.) The names need lo l>e 
abstracted enough so that tliey are not tied to network 
addres.sing, etc. 


Finally, the protocol needs to bv simple, so that any device 
that can use the carrier protocol, like TCP/IP for 
Zeroconf, can easily implement the SD protocol as well. 
Giving tn to the desire to have an infinite numlKT of 
o[)tit>ns will make implementing the protocol so complex 
that if won’t he used. 

Service Instance Naming 

We .should figure out how^ to name the service instances so 
they can be Found easily. Well, DNS provides us with a useful 
way to do lliis—the SRV record. If you think a[x)yt it, most 
services of a given type—^say, printers—only tend to differ by 
name (i.e. - a list of Ipr printers will all have the type 
“„printer_U:p.domain.com”). So finding LPR printers in a domain 
is pretty^ simple. However, unlike services such as web servers, 
you don't want to lx? load-balanced. Getting rotated to a random 
primer ixx:au.se tlie one you wanted was i>usy w<suld get 
annoying rather quickly! To avoid getting rotated to a random 
instance of a service, an additional level of indirection gets 
used—Ihe PTO records. 

The client requests PTK records (which are pointers from 
one name in a DNS space to another name in that space). 
Hie result of a PTR ciuery is a list of service names in tlie 
form ""Service Instance Name == instance.service.domain". The 
instance in this result is a single Unicode UTF-8 encoded text 
string used for the DNS label. Note that the service name is 
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not the same as a host name. The user doesn’t manually 
enter the DNS information for the seii^ice instance, but 
selects them from a list, via the Chooser or the Print Center. 
Once the selection is made, ilie service can be used and 
possibly saved in a config/prefs file for fuaire use Ci.e. - 
default primers). DNS labels are limited to a 63 octet length, 
and U'rF-8 encoding can use up to 6 octets per character 
depending on the amount of data needed to display a given 
character. So a simple character set—like the standard Roman 
alphabet—would be able to use 63 characters for die name, 
whereas something like Egyptian hieroglyphics would be 
limited in si^e to something like ten characters. 

Resolving the Service Name 

Now that we have a name for the service, we have to 
resolve that name to a device in order to communicate widi 
it. Once the name has been selected, tlie client sends a DNS 
request for the SRV record for that name. This returns the 
ICP/IP address for the service instance, applicable port 
number for the instance, and the target host for that service. 
If the network is a Zeroconf record, there may not be a well- 
defined host name since, in a Zeroconf network, yon may 
not have any DNS servers, in .such a case, llie target name in 
the SRV record may be the same name as that SKV record, 
which contains an attached address record with the IP 
address for thar service instance. If there are multiple hits 
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from a request, pric?rity and weight fields must be evaluated 
by the client to select the most appropriate instance. This 
would allow some load-l:jalancing of instances—say, to 
manage printers in a pre-press shop, or for pulling down 
network updates to clients from various file servers. Not all 
instance.s are created equal eitlier, and some require more 
than just a TCP/IP address and a port as a reference. LPK 
print servers may have multiple queue names; a file server 
may have mukiple share points. In these eases, TXT records 
with the same name as the SRV record, and contain this 
additional data, are used. 

When doing c|uenes you may need to be more sole Clive. 
Fcjr cxarnf)le, in a large pre-press environment, you may not 
want to get a list of all printers—there could he hundreds. 
So, you can create more .selective queries by adding 
restrictions to the request. A request for 
“_postscript.Jpp._tcp.domain.com” would only give you a 
list of postscript printers using the IPP network printing 
protocol, as only those types of printers wtmkl have the 
apijropriate PTR records pointing to their names. 

I^opulaliiig DNS w ith SD Information 

For DNS%SD to work, you need to have the required records 
filled with the needed information for the services provided. 
'Iliere are many options here, most of which can lx: used now 
for eonvenlional DNS functions: 

Yf>ii can always manually enter the information into the DNS 
.sei'ver's configuration hies. This is tedious, but not onenrus 
ifi a stable environment. 

A network monitoring too! can, upon detecting new devic:es, 
create a zone hie that will be read by a standard DRS server 
that will automatically uixlate the server’s records. If you 
have a huge number of changes happening at once, or 
regularly, this is a gcxxl option. 

Devices can use Dynamic DNS (DyDNS) to automatically register 
SHV/FFR records with the DNS server. If you are already 
using Dynamic J.)NS this can save you some time. 

A device manager can also use the 13yDNS uixiate mechumsm 
for devices it is managing. So an MR JetDirea print manager 
could auromarically update F)NS records via DyI>NS as new 
printers showed uj). 

Zeroeonf devices will answer mDNS requests for SRV/Pll{ 
records in .Itx'al. 

There is no specific reqLiirement between DNS-Sl) and 
mDNS but they do work well together, e^specialiy in a Zeroconf 
environment. In such an environment, PTR record lookups of the 
Ibrm “scrvice.Iocar use multicast and return a list of instances of 
the form “instance.service.local". In this type of implementation, 
the TTL. fr)r the DNS recoicLs should lx: short enough to avoid [>ad 
IP address mmslalions but long enough m that once a name has 
been displayed on a given host, that host doesn’t have to 
contimioiisly re-verify the existence of that instanc'c. 
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Comparisoiis with Other SD Protocols 

Since there are several other SD protocols available for 
usL% why not use one of them in 7eroconf? Welh as it turns 
out, DNS has a tot of advanta^'cs. First, it's imc of the c]ldest, 
most robust and best-understood SI) protocol. It .scales 
globally (even more widely if you count links to various 
Sliutlle fliglus, the Space Station Freedom, and some of the 
Mars missions), and fits in with every network 
troubleshooting tool on the market today. Since Zeroconf is 
using DNS for name setup anyway, using DNS for service 
dtscoveiy is a logical choice. 

Another advantage to DNS is ubiquitousness. Almost 
every large network has its own DNS server, and many mid¬ 
size networks do as well. So, there is a very large DNS 
support population available. DNS already has a dynamie 
registraiion protocol, so automation has been done. DNS also 
has its own security imfjletneniaLion, so using DNS for 
service discovery avoids that work as well. In short, DNS 
today has everything that SD wants, and very few downsides 
for SD usage. The only tiling missing is mulLieasi modes, but 
mDNS is moving toward hectmving a standard, and is in use 
already, so that problem will take care of itself in short 
order. There is no reason to reinvenl the wheel yet again 
and create an overbuilt, hard to use SD jirotocol when DNS 
is here, and easy. 

COC^^CLIJSION 

You now^ have a better idea of what is going on behind 
Rendezvous in Mac OS X 10.2 and later. Note that 
Rendezvous and Zeroconf are not theoretical ''Soon we’ll all 
eat pills for meals and sleep in capsules” flights of fancy. 
They are here now', doing work now—and thanks to Apple's 


release of the Rendezvous source code—developers have an 
example of an implementation of these things lo work fnim. 
Ime, iChat is the most visible example of this, and most folks 
may not realize from that bumble application the brilliance 
of Zeroconf and its iin pie mentation. Bui then, they probably 
haven’t used the Rendezvous implementations of iChau J was 
amazed at how w^ell it w^orks and how easy it makes things, 
and I am a netw'ork administrator. Zeroconf is what TCP/IP 
should be for users, and again—we have Applt% and Stuart 
Cheshire to thank for it. 

BiBUOGKAPUY and EEHiKBNCES 
All of my source rmiterials come from Apple, the IETF and 
conversations with various people involved with Zeroconf. 
Some [)eitinent URLs arc' 

• http://www.zeroconf.org/: Tliis is the Zeroconf home page, and a 
great place to sum undersUmding Zeroconf, allxM! cjuite 
technical in nature. 

• http://www.apple.com/macosK/jaguar/rendezvous.htfnl: Apple's 

Rendezvous home page. 

• hltp://www.apple.com/macosx/pdfs/Rendezvous_TB.pdf: A PDF Ole 
that gives good, fairly non-rechnical information on 
Rendezvous. 

• http://devetoper,apple.com/macosK/rendezvous/lndex.html: Apple's 

Rendezvous Developer site 

• http://wvwv.multicastdniorg/: mDNS home page 

• http://www.dns-sd.org/: DNS-SD home page 

• hTtp://wwwJetf,org/htmlxharters/zeroconf-cha]ter.htmi: IFIT Zeroconf 
Charter page. 
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DIGITAL 

PHOTOGRAPHY 


By Neil Ticktin, Publisher 


Nikon DlOO 


Been waiting for that serious digital 
camera? Wait no longer. Here’s a geek’s 
perspective 


MacTech is a magazine for developers of all types. As the 
technical lieart of the rominuntty, we*re all consianlly asked 
quesUoas by others alx^ut anythhig related to computers. We 
thought it would be interesting to describe a non-developer 
topic in detail. Ibal way, our re;tders would be belter armed U) 
answer questions from their friends and cohorts ... you know tlie 
questions like “Which digital camera should 1 buy?"', or "How 
many megapixel should I get?'\ I.et us know what you think of 
this article. 

The Dilemma 

If you are like tne, you like tt> take pictures. Vur years, IVe 
been a Nikon guy, having lx>ughi iny first Nikon (an liM) many 
years ago. 1 loved my Nikon FE, but as we moved into \hv W's, 
I was irritated by Him. fm a digital kind of guy. 

Over the past few^ years, 1 poked arouiKl at digital 
cameras, experimenting with tlie name brand consumer 
electronics soluiions for digital camera.^, but they all left me 
flat. Don’t gel me wrong, they were great for taking snap 
shots, but they frustrated me lx!cause I couldn’t gel the kind 
of pictures I wanted. 

Enter the Nikon DKX). 

The Pro- siTMER 

If you are the kind of phtUographcT that lakes more than 
snapshots, hut you aren't at the prufe.ssional level, you may lx* 
a “prcKSumer". M you are willing to pay for ii, there are 
soiuti<m.s out there that can really gel the job done for you. 
Tliese cameras are lor the serious photographer, amateur or 
profes.sional. 

Now, if you aren’t willing in spend a couple of thous;ind 
dtJIars for a DUX) setup, Nikon does have txher solutions, and 
their C(x>lPix line is quite good with a variety of (jptions. 


Similarly, other vendors have some gotxl soluLitms but, it all 
comes down Uj what you are comforialjle with, 

In my investigation, I looked at a variety of cameras ... 
including die Canon DIO (Cinon’s entry into ibis market). What I 
fountl is dial Ihere arc Nikcjn fx^iplc, and there arc Canon jxople. 
To me, the Canon felt fumiy in my hand, where as die Nikon fell 
like home ... then again, this is my fourth Nikon SLR and fve 
taken many dious^inds of pitiurcs with Nikons. It’s scctind nalUR* 
for me. Now, everyone ran tell you why their camera is better 
than the odier guy's, but in die end, you netxl to pick ibe camera 
up anti play wiili it. If you like it Ixiter, it s for you. 

Make sure you are eomforlable with it — a DlOO goes for 
around SKjOQ on the street. And, this is ju.st the bocly, no lenses, 
no external dash, no case, no niemoiy card ... just ihc Ixxjy, 


figure h Nikon l>!00 Body 

The Basics 

Before getting into wiiy the Nikon D UX) is eexd, here’s die 
es,sential information that you'll neexi. The DKX) has a large 
CCD, equal in size to that of the Nikt>n Dl series professional 
cameras, but with higher definition. The camera features 6.1 
million effetnive pixels which produce ultrahigh-definitiun 3,008 
X 2,{KX)-pixel images. Quality in fact that rivals film priming itself, 
according to my professional phottigrapher friends. Any more 
resolution mighi lx a waste for niost. 




Neil Ls ilie pui:)li.sher of MacTech Magazine. As a cicxsct geek, he tend.s to experiment with some of the more interesting forms of teclitiology, and then 
friglitening die niagazme staff l)y annount ing he‘11 write ahoui them. You ran reach him at publisher@fnad:€dh.cofn 


32 


Nikon DlOO 


MAdl'Kai • May 2003 

















...this really is easy: 


WIBU-KEY Software Protection 


■ Software goes online 

Electronic Software Distribution 
safely protected by WIBU-KEY. 

■ Pay-Per-Use 

Usage dependent accounting of 
your software. 


■ License Management 

You can easily and flexibly create and 
manage network licenses. 

■ Mac OS 9 & X 

WIBU-KEY supports Mac OS, Windows 
and heterogeneous networks. 


i:hfi Pv^tactfon \C\f. 

fraa daadct for yofjr::r;[fJ 

nor.fi .ro r N 



The Key is in Your Hands! 


UIBU 

SYSTEMS 


WIBU’SVSTEMS USA< Ini. 
Seattle* WA 98101 
email: info^wibu.com 


www«g' 

WWW, 



Test Kite also available at: 

eclqium wtbuJtihnpfllit be. Denmirk re4nVClant)iit.dlu Finland Ilnedjdf-efknebyie.cDfnt, France infoOnaol.tr, Kyngiaiv Japan InfbttittncAfla.c&.lp, 

J^CKiian, Letiangin narwff^CyberlajnEt lb. Kutea dhkfnirfn9vuJby.co.br, LuKembmirg uvibudlrr^Alit he. Nelherrfabnds v^buOiinpiikt be. 

Portugal dubUOdyhit.pi. thaibnd pf&ecHa9dpft.th.<om, OriitfMJ Kingaom Into9codework.coni. 






















There^s a couple 
of features that make 
die DIQO stand out 
from a photography 
point of view. First, 
Nikon has incredible 
color reproduction 
with very smooth 
gradations between 
the colors. Automatic 
while fialancing is 
done through an 
innovative 
methcxlology that yields more precise color Temperatures. And 
the light metering is done not algorithmically, but checking the 
conditions agaiast a database that Nikon has built up from true 
exf^erience, not a formula. All of this is done aiiiomaiically, and 
it's fast. 

While lliis camera is not small, it is compact for whai ii 
does. The bcKly weighs in at 700g/247 oz. The D lOO features 
a five-Area Autofocus system. 

With a lop shutter speed of 1/4,(X)0 sec,, the flash sync 
speed goe,s up to 1/180 sec. ISO etjuivulency 200 - 160(J, bui you 
can Ixjost it higher if yon want. 

It not only has a USB 1,1 interface, but also takes 
CompactFlash I'ype 1 and 'l ype II cards, including SliMB/lGB 
IBM MicroDrive. And, if you are wondering about these, 
here’s a couple of tips. If you have a fast camera like the 
1)100, you will notice the difference between the speed of a 
high-speed Coinpact Flash card, and a low-speed one. A 
MicroDrive, w^hile very cool for its large size, will he about the 
same speed as the slower Com pat: t Flaslj cards. Also, 
MicroDnves are m)l known for their robustness — one drop, 
and it might Ix^ over for the MicroDrive, whereas Compact 
Dash cards have Ixen rumtxed to survive the washing 
machine and still work. 

There are a whole slew of other specs that you can read 
on the Nikon web site, hut let's get dowTi to the nitty gritty 
of this camera. 

Camioia Spfed 

1 tltink lliat the smiill, ctmsumer electronic ettmeras are very 
c<K>l, Tliey are so small that you liave jio excuse to not take 
pictures of your vacaLkm, kids, 
or whatever. AJl of these Inily 
conifracl cuments are deiiigned 
to Lie simW and inexpc“asive 
(whether film or digital), 'Ihis 
works against tlie ide^i of 
control, features, anti speed. 

As an example, the 
average consumer compact 
camera lakes Ixrween 500- 
1000 milliseconds Ixom the 


time you press the shutter release to the time that the plaure is 
taken. That’s half to a full second! 'Fhar may not seem like long, 
but if you are trying to catch an acaion ,shot, or that special 
moment of your kids, it's the difference between getting the 
picture and not. 

Ihe DlOO takes the piemre in 60 (yes, sixty) miUiseconds. 
Need I say more? Ok, 1 wdll. That’s just the time to take the 
picture. Focusing speed on these ^LRs is really tjuick ... 
especially with those lenses with internal motors in them. In 
Nikon^s case, these lenses are the ones with the ‘’Silent Wave” 
motor built right into the 
lens, On top of it, you 
may want to lake a rapid 
succes,sitm of pictures 
the DlOO can take 3 frames 
per second, for 6 frames. 

Which, when combined 
with a high-speed card, is 
more than enough in my 
experience. 

Why does the speed 
matier? It tnily makes a 
clifferenrx" on getting piaures 
even f>n simple things like 
action or kids. For example 
see rigiire 3 wiiii the ball 
miciatr, or uike the below 
scxiuence t Figure 4). You 
can see the piniire emerging, and clearly the fourtft one is llie best 
one, Imi you would either have tf> lx* extremely lucky, or look at 
a raf>id fire sequence to really capture the moment. 

CoNixoLLiNG Yoim l*ic:niRF Taking 

The DlOO sports four exposure nuxles, Auto-Multi Program 
(Flexilile Program possible), Shu Her-Priority Auto, Aperture- 
Priority Auto, and fully Manual. You may very well use the 
Auto-Multi Program quite a bit, f>ut there are times that you’ll 
want to use the others. For those less experienced with 
photography, let rue explain. 

RH’s say you are .shooting aciion ... like a kids’ soccer game. 
You want to lye able to stop the action of the ball like in Figure 
3, so you may use .slutticr priority or a manual setting. 



Figure 4. A rapid fire seqmmce makes all the difference in captwing Ibe shot^ 



figure Z Let the Nikm sojlware deal 
unth tough spots like shooting 
agaimt snoui 



Figure S Shot at 1/1000^^ of a 
second, }^)u can read the 
wriiing on the hall. 
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W MIX 

WIN[K>WS WACINTOSK MAC OS X 


[Thinkfree^ 


ThirikfreeOffice 

COMPATIBLE WITH MICROSOFT WORD, EXCEL AND POWERPOINT 
WORDPROCESSOR • SPREADSHEET • PRESENTATION GRAPHICS 

The Affordable Office Alternative! 




TNnkfree is a 
tjesl'Of-breed pcogram 
that will exceed your 
expectalttwTS * 

— Jeffery SErffersby 


Mac/lddci ratho 

ooooo 


GREAT 


"Thinkfiree Office is the 
next best thiog and 
then some,'* 

— Detorah Shadovits 


"Thinktfee Office is an 
frnflCHQfyC^ impressive attempt to 
^ crack the seemingly 

im penetrable 
productivity market." 

- Chris Ward 


amajtonjcoTin. 
Apple Store 
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Three High-Performance Applications 


Thinkfree Write 

Thinkfree Write is a powerful word processing application 
that enables you to create rich, professional quality 
documents and Web pages. You can insert tables^ 
images, and clipart, or even opply custom layouts to 
your document...then effortlessly proofread your work 
with the eosy-to'use spelling and auto-correct ion features. 

Thinkfree Calc 

Thinkfree Calc is a full-featured, easy-to-use spreadsheet 
application that can easily tackle the most complex 
analytical tasks with over 40 charts and 300 function 
capabilities, Thinkfree Calc opens, edits, and saves 
directly into the Microsoft Excel (.xls) format, so users 
can seamlessly share documents and collaborate with 
Microsoft Office users. 

Thinkfree Show 

Thinkfree Show enobles you to create high-impact 
presentations including onimation effects, drawings, 
images, clipart, and other graphic features. Thinkfree 
Show opens, edits and saves directly into the Microsoft 
PowerPoint j.ppt) format. 

CyberdrivePlus 

A free, one-year subscription to CyberdrivePlus is also 
included. CyberdrivePlus provides you with secure, 

Internet file storage ond free online software upgrades! 


ONLY 






Thinklrea cntd Thinkfree Office are ImtxiBmarks of Thtnkfrw CorporolEon. All oiher Irodenwarb ond/or registered trodemarks ore properties of their respactive owners 

























































Or if you are trying to compose a shot and you want lo 
control the depth of held (e.g., by changing aperture sellings), 
you am go for effects like ihose seen in Figure 5- 



Figitre 5 CoJtfrolihtg tte ckpib af field ccm lx* dranu{tk\ 


Nikon Ijnsks 

Nikon, more than anything else, is known for iheir 
incredible lenses. Vie c(K) 1 ihing about Nikons is that if you 
have older lenses (any Rype mounts since 1977), they wii! 
work on this camera, hut, even if that's ihe case, you really 
want io ItK>k at ihe nt:wer lenses for their features, s[x:ed, weight 
and of course, clarity. 

'rhere is something that you should know aliout digital SLRs 
and lenses when coin[>aring ifiem lo him SLRs, In most digital 
SLR.S, the si/e of ihe CCD is physically different than the size t>f 
a piece of 3^mni film — even iliough the quality is alxmi ilie 
same. As a result, on the DKX) the fcx-al lengili of the lens is L5 
times that of the .same lens on a film camem. In other words, if 
you have a 7th3(K)mm lens on a film camera, and move that 
same lens to a DlOO, it's the equivalent of 105-^i60min. Why is 
this the cuse? h's a Ni tricky to explain, but U's similar to why 


an image projected on a movie scteen gets larger and smaller as 
you move the projeetor fartfier anil closer lo the screen. As a 
point of reference, the Canon DIO has a L6 multiple. 

We IcKikcd al twi> lenses ... and we find that they sene our 
need-s (jidte well 

The first Is the 2 i-85mm AF-S Z<x>m-Nikkor. x\gain, 

realize tliat llits lens Is equivalent lo a 56-127inm leas on a film 
camera. A cx>uple of things alxnit this lens—the AF-S means that 
its aiitofociLs has the silent wave motor Aside fn>ni this motor 
l>c‘ing sii|XT fast al ftx using the lens (and I mean it's rc’^illy fast), it's 
nearly completely silent ... so you won’t be distnii:Ling anyone witli 
h>cusing noise by ilie lens. Second, the ''G'* part of the leas 
dc‘sc:rilx.*s a new direction tliat Nikon (and othcTs) are taking. It 
means tliat there's no aperalure ring on the lens. This has the 
Ix^nefit of reducing not only the weight <if the lens, but the cxxsi. 
You want to cliange the af>eralure? No problem , it's tione by a 
sulxommand dial ttintroiled by your index finger just lx.-low die 
shutter release. Tliis lens nins anmnti $i% on the stieet. 

Tire .scxxmti fens i.s the 7fi-3lW)mni f/4-S.6D HD AH Zoom- 
Nikkor, wludi I use for two jxirtxjses. Hirst, to catch pictures (»f 
|X"ople in candid siniations. Tliis is a long enougli lens tliat in w^ell 
lit siiuaiions fe.g., daylight), you’ll lx- able to take a picture of 
soiiieone and they will ne\?er know it (see Ilgure 6). It really is a 
huge help to get some wonderful amdkl shots, es[X‘ciaIly of kkfs 
or animals (like an unsusf>etling water fowel (see Figure?), 'llie 
second tiling is for aetton sliots ... like sh(xrting at a sporting event 
like a stKcer field, or 
basi4>all game. This 
lens runs around S ^ni) 
on the street. Why so 
cheap for so much 
lens? The biggest 
difference IkIwcx-h the 
professional leases imtl 
these is the f-slop. 
xMany of the 
prolessional leasers go 
down to a f2 H 
allowing for lower light 
shtHJting, Hien again, 
those lenses are 
typically around 

both of these 
Ieo.ses use Nikon's 
“HD” Cl lass, wliidi 
according to Nikon, 
gives you superior 
overall optical 

[jcrformance. Tliis is 
achieved by an optical 
design ieainring HD 
(Extra-low Dispersion) 
glass elements for 
minimized chromatic 



Figure d With kntgih. 

}H}u can ht' quite a distance aimy. ft 
nutkes it easier to imtch for that neat shot, 
in this "iiayimtcb. the einiy 
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BIGGER VISIONS 


THE NEXT BIG THING FROM APPLE 


REVrEWS > LEARN ABOUT THE LATEST APPLE PRODUCTS 


Creative designers, writers, musicians, business leaders 


AND OUR TECHNICAL EXPERT T^M OFFER THOR OWN PERSONAL 
INTERPRETATION OF THINGS THAT ONLY THE MACINTOSH SYSTEM 
CAN DELIVER. FEATURING OVER 24O PAGES OF REVIEWS, INTERVIEWS 
PRODUCT NEWS, JNSIGHTS, TRENDS AND THE LARGEST MACINTOSH 
BUYERS* GUIDE. SUBSCRIBE > $3Z/l YEAR (4 ISSUES} OR $$ 2/2 
YEARS (8 ISSUES): WWW.MACDmECTORy.COM/PAGES/ADVERT.HTML 
OR SEND CHECK OR MONEY ORDER TO! MACOIRECTORY SU6 DEPT, 

326 A Street, zQ South Boston MA 02110 


iMacDirectoiY 














ab^jrration, and 
aspberical lens 
elements for low 
distorticjii TVe sliot 
pittui'es with kith 
The KD and the 
standard glass. 
Where you really 
see the difference 
is in sliai 7 >ncfjsS of 
Z The immr of zoom can make pictures. 
all the difference in whether you scare off Bottom line: 

)>oiirsubject tJnless you havo 

some driving 

reason not to . go with the ED glass, it makes a ditf'erence, atid 
it s wonh I he exini money (see Figures 8 and 9). 

Yt3u may also decide that yt>u want to get a lens that does 
wide angle if you shoot a lot of scenery shots that require it. 
Kememiw, yon 11 want to go with a wider angle than you wa)uld 
on a film camera because the focal length will gel multiplied by 
I3x on the 1)100. 



Figm^ a ^fhe ripples in the water tel! ail. 



Figure 9- Check out the sharpness of the sand on his knee. 


One last thing. Without naming names, I tried other brands 
of lenses, Tm now only using Nikon lenses on tliis camera. 
Olwiously, there’s a reason, 

SoFmARK AND File Formats 
Tlie DlOO can store the files in NEF, TIFF and JPOs. Most 
people are shooting with jPGs because they are easy to move 
akjut, and tliere are a numlx^r of services available us them. 
TIFF is not comt>rc.sscd, ,so you have no lo,ss in image quality 
(ihcTe is some with jPG), but honestly, I can’t see a reason to 
use it, NEF (Nikon Electronic Format) is very cool in that it gives 
you all the raw' data you need to mnk fn)m, and is still only 9 
mega bytes for a full resolution [)ictiire. 

The camera works with a couple of pieces of Nik()n 
software — Nikon Vlew^ S sofiw'are enables transfer and 
viewing of images on your computer (or you can use 
iPhoto). The optional Nikon Capture 3 software for excellent 
image managemeni and remote operation. 


Shooting in RAW Formats 

One of the ccxdest linings that can lie done with a Ingher end 
digital cameiu like the Nikon 1)100 is the aliility to capture and 
work w'iili raw itiiages. In tiiis case, the 1)100 uses NEF’ or Nikon 
Electronic fortiiat as the file Ibmiat. In this format, i]ierL'’,s a jpg 
tiiumbnail tliat makes il so that you can t>pen die picture in 
^siandaicP applications, but more im]X)ruintly, there’s an instruciion 
set and tlie raw CCD data. Wh;u’s really ccx>l is that you can opt:n 
this NEE file in the Nikon software (Nikon View, or Nikon Capture), 
and you can work magic with it that you cannot do with a jpg. 

For examj^ile, the wliite balance settings on a digital camera 
are critical. If you shoot in the wrong setting, you can end up 
with pictures with a blue cast, or a yellow cast, etc,,. You can 
shoot using die camera in an automatic white balance mode, liut 
most professionals will shoot by setting the w'hite balance 
manually^ or by selecting a white balance mode of direct 
.sunlight, cloudy, incandescent lighting, flaurescent lighting, 
flash, etc.,. Make the wrong choice, get a weird color casting to 
the picture, NEF and the Nikon s<,)ftware allows you to change 
the white balantre ,setting after die picture is taken. 
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As an addiiional example, yon can also push the expexsure 
levels. For examj:)li% film process allows a photographer lo posit 
by a Few F-stops. Using the DlOO, yoit can do the same ... and 
if you sluxjt in NEF and use Nikon software, you t'an do it after 
the picture was taken. 

Fiashrs 

Flashes today are more integrated with the camera than 
ever. 1 strongly atlvise that you go with one of the Nikon Hashes 
u> lake advantage of the fiest integration you can. 'Ihai pretty 
much gives you llie choice of the Nikon .SBoODX and the SB- 
80nX. Both of these provide compatibility with D-TTl. and 3D 
Multi-Sensor Balanced Fill-Flash controls. The SB-801 >X is a 
newer Hash, and cosLs more {close to $500 list), but 1 haven't liad 
enough time with the Hash to make a recoin men da I ion on 
whether it\s wonh the extra dough. For coasumer.s, the SB- 
50DX will do the job fairly well and is a perfect match for this 
camera. Whatever you do, try to get an extemal Hash. It helps 
reduce red-eye {by being up and away fonn the image plane). 
Yt>u1l also be al)ie to use the Hash at longer distances. 

Be Carefetl 

Ytm may think alioui buying a CTimeni from one of tliose places 
tliat advertises su|X?r low f)rices. Be eanjful. Only work with those" 
with a good reputation. 'Ihey tend to am several semtis in these 
f)lac‘es. First, ihey sell ‘'gray m;irket" aimeras wliich wea" ncs 
imixmc"d by Nikon USA, l>ui wea* f)urchased by a consumer in the 
USA. Expect to be .sold an extended wamtnty, aiid to jxiy for 
shipping at up to Sx tlie going nite (which they may make non- 
afundable even if ytm reium ihe ['amera}. Bononi line: Only deal 
w^ith repuuilile places, store fa>nts, or vendors tiiat you are used to 
buying from. Otherw^ise, you may end up with a pioduct tliat 
dtx.'snl have a IIS warranty, or is missing manuaLs or accessories. 

Sharing with the World 

Apple's iPhoLo has its wtraknesses, mostly in that it's very 
slow, and limited in its oiganizing capabilities, but it makes 
fanta.stic slide shows very quickly. You can take these slide shows, 


save them to QuickTime, opiiiiiize them through pix>grams like 
DLsc'reet's Cleaner to make them smaller, cross platfomi, ^md 
overall l)etter for sharing via Ihe web ... and you will be die 
favorite of all for putting togedier tiered slides. Tliem's nrahing like 
photos pur to music it touches the heart. Cleaner is a fabulous 
pnxJucl diat will allow you all kinds of flexil^ility in working widi 
QuickTime and odier file formats {see http://www.discreet.com/). 

With all the piemres that Eve taken, IVe I>een using a 
combination of iView Med in Pro <htTp'//www.iview- 
mu!limedia.CQin/> and iPholo. iView is exceptionally gtxid at 
moving through a lot of pictures wry qiiickly. It gives you die 
aliiliiy Uj organize them, and the scrolling speed alone makes the 
program worlhwiulc. If you are .serious, you will probably end 
up using this product. iView can also handle NEF file.s by 
IcKiktng at the jpg embedded in the NEF file format and does a 
far suiKTit>r job at diis than ildioio does. By the time you read 
this article, there will be a consumer version (iView Media) that 
may be a better solution for you than iPhoit>. 

And, if you are interested in a ntnit little site that allows for 
easy uploading of a lot of pictures on the web, check out 
http://wwwdoikixom/ which ha.s st^me of the features of iPhoto's 
online sharing as well as ofoio's but at a much lower cost. 

Nikon Resources in Learning 

There's a ton of stuff on the net that's helpful to learning 
about taking pictures. A new resouRC that's out there is the 
newly launched SLR Learning Center by Nikon. See 
http://www.slrleamingcent0r.com/ ... and ifs especially aseful for 
those that want to know' more, bul are nor ciirrently at a 
profe-ssional level of photography. 

OlNCLUSION 

You probably can guess that 1 iK>t only like diis catnera, I 
love it. As of this writing, fve now shot over 10,000 pictures 
wilji it, and ifs brought me track to a true love of photography. 
Caipturing moments in a way tliat makes me feel like an artist. 
Yes, $3500 is a lot for a full .sysrem ... but it's the best money 
Fve spent in a long, long Lime. 
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MAC OS X 

PROCRAMMIMG 

SECRETS 


By Scott Knaster 

Mac OS X: Wading In 


'rhis i5 the tirsi episode of Mar OS X Pro^ramininj^ Sucrcls, 
and there are ahoiil 12 billion possible topics to write alx^ut in 
this ricii, largely unexplored operating system tliat’s gradually 
but inevitably taking over the Madniosh w'orld. Most months, 
this column will fcxais on cool prt>gramming things, esjmially 
the nifty newest tines that Apple tosses our way. llatlier than 
present a programming topic this month, we're going disciLs.s 
a rolleclion of tips and schticks you tan usc^ to improve your 
daily OS X work and j>lay, whether writing ccxle or just nerding 
out. Some of these might I'le familiar to you, but I'm gue.ssing 
you'll find at least one or two that will make you say "ctxil!" (or 
at least "ohO, 

Om Heritage 

Before we start in wilh tlie ri[)s, let's take a moment tt> 
esialilish some common grounrl Mac OS X is a strange and 
wonderful aggregation of very different Technologies: 
Macintosh meets Unix^ by way of NeXT. Apple peiTonned a 
remarkalile engineering feat in lifling up Mac OS and shoving 
Unix into place underneath. Not only does this affeci ihe 
tools and applicatkms we use, it'saLso rellecied in the liuman 
romnumiiy of Mae programmers. Some of us, including me, 
grew up with the "classic" Mac, while other OS X tU'Volees 
come from the land of Unix. Perhaps the luckiest/smartest OS 
X programmers are those who stuck witli NeXTSTPF through 
all these years. And the better OS X gels, the more Windows 
programmers are peeking into the tent to see w^hai all the 
fuss is ahoiii. 

Since the Mae was introdueed, one of Its l>iggest 
attractions has been that it ihe command line 

goofiness that used lo rule the world, so a lot of us have spent 
the past 20 years mostly staying awray from Unixy things. Of 
course, the user interface for Mac pnigramming tools has 
always been a source of controversy: sure (says the argument), 
pretty and easy user interfaces are g(M)d enough for mere 
users, but real programmers are differeni. They need llie 
power and control of command-line tools, Tliis debate has 
resulted in divergetil philosophies in programming tools, with 


slick integrated development environments (IDEs) on one side 
and command-line shells on the other. Most modern 
programmers end up with some t>f each, with grapliical user 
interfaces on some tools and command line connections to 
others, although there are purists who live and die in the shell 
and won't go near a pretty IDF even if you offer them 
unlimited Jolt Cola. 

Vm an old Mac guy wUn saw the GUI light in the early '80s, 
I prefer the boulevard ride that A<|ua provides, but TVe spent 
many an hour careening tlirough command lines and I'm not 
averse to going there wlien power, control, or necessity 
demands, as it often does in these early days of OS X. Plus, 
figuring out somclliing nerdy thrills me as much as it does the 
next geek. So while I'll usually lx.* looking for an easy Aciua 
solution to problems in this column, we'll have plenty of fun 
under the hood in ihe cominand line loo. The great thing about 
Mac OS X is that it lets us mix and match Aqua apps with 
command line tools, and it even provides some bridges 
between the worlds, 

Terminai. CoNornoN 

Ihe Terminal appltt'aiion is the trap door that gets you 
from nice Aqualand, wlierc all the natives know how to point 
and click, to the shell, that place of exposed wiring and 
ductwork, ahsohite power, anti little protective fencing. As 
ytni likely know by now, Apfile puts Terminal in the Utilities 
ftilder of yt>ur Applieations folder, where your mtuher wtm'l 
stumble upon it. In a Unix pa lima me, you would refer to this 
location as: 

/Applications/ULll it le.B/ 

Terminal starts a ses.sion with a Unix shell, an interactive 
pRjgmm that lets you issue commands to your computer, 
which it then olx 7 s precisely and wiihmil cjuestion. Of 
course, your idea of ihe command migln not always be the 
same as the shell's interpretation - but it always wins. By 
default, Terminal u.ses a shell called tsch, one of several ilniE 
come with your Mac. 


Scott Knaster has been writing about Macs for as long as ihei\‘ liave \wn Macs. Sttjft's Ixxiks How To Wdie Modntosb Softttfurv and Maemtosb 
pTr>gramming Seavtx were recjuired leading for Mac programmers for more tlian a decade. Scott WTOie develo|X'r IkioIcs fur General Magic' and w'cjrked <JO 
Mae soflwaR* for Micr(.isoli. Scrott's !x>oks have Ix^n tnaislated into Japanese and Pascal. Scott bis every Issue of Mad miiggzine, which cxplams a lot. 
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Youll spend a lot of your Terminal lime typing pathnames 
of files and directories. For example, if you wanted to see a lisi 
of TiTminal's fellow urilities, you could type 

la /Applications/UtniT-le^/ 

Is is the shell command tor listing files in a directory, and 
/Applications/Utilities/ is the argument, or ihe dirccioiy we want lo 
see listed. (I don't want to get off on a rant here, but many sliell 
eommand names aren't just non-mnemonic, they're wildly 
mcoiisisteni. Hut there are /illioas of prognmimers w'ho know 
them hy heart and have Ix^en u.sing them since Reagan was 
president, so I flings are not likely to change. If you haven'i 
grown up using Unix, ytiii will likely never memorize most of 
them, so the liest thing lo do is get used to it and consider 
adding a stic'ky note next to your computer until you learn the 
ones you need.) 

To make your pathname'typing life easier, the shell includc^s 
a shortcut for autocotnpleting pathnames. If you press Tab while 
ly[nng a [xuliname, ihe shell will kindly fill out the rest of the 
pailinanie, up to the next slash, accoaling to the files in the 
directory you're addressing. Well illustrate this valuable tnek by 
getting a listing of /Appfications/Utilities/so we can see what other 
nerdy goodies are contained inside. First, let's take a look at the 
root directory: 


scott% Is / 

Applications 

Users 

Applications {Mac OS 9 ) 

Volitmes 

Cleanup At Startup 

automount 

Desktop (Mac OS 9 ) 

bin 

Deaktop DB 

cores 

Desktop DF 

dev 

Desktop Folder 

etc 

Developer 

mach 

Docunieats 

inacb, sym 

Library 

nLach_kernei 

Wetwork 

private 

SysLctii 

radiohead 

System Folder 

Temporary Items 

sbln 

tmp 

TheVoltimeSettingsFolder 

usr 

Trash 

var 


As you probably already knew, the shell shortcut for your 
root folder is a slash, and if you didn't know that, you just picked 
up a handy tip. To Uy the Tab autfx'omplere feature, open a new 
Terminal window and type the following: 

Is ilih 

and then press Tab (don't press return). You'll see that the 
sbeU completes the pathname up to the next slash and makes i\w 
t:omimnd Is/Library/ , s;wing us from typing the rest of the file 
name. Th:tiiks, shelll We ctmid have gotten the same result by 
typing Is/L and then pressing Tab. Afler pressing Tab, the inserrion 
point is now' at the end of the second slash, so w^e could kee[> 
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typing from there, but we'll just prew return to see tlie concents of 
/Library/, Thanks to my buddy ZZ for the clue ticket on this one. 

Now that weVe seen how the Tab shortait works, let's 
get that listing of the Utilities directory. We can reuse the Tab 
trick at every subdirectory level if we want. Start out by 
typing Is /App and then pressing Tab. The shell fills out the 
line to readi 

Is /Applications 


session. This is incredibly handy if you have to type a 
long, complicated command; with judicious use of the 
arrow' keys (down-arrow moves forward through your old 
commands), yoti'll never have to type it more than once 
per shell se-ssion. 

If you don't want to use the arrow keys to move through 
commands one at a time, you can use the history cximmand see 
every darn command (up to 100) youVe issued during this shell 
scission. Here's what it looks like: 


and the Mac beeps at us! So rude! What's going on? 
Take a look at the listing of the root directory above. Note 
that there are two entries that start with "App'’: 
"Applications" and "Applications (Mac OS 9)’L When this 
happens, the autocompleie feature can't be sure which one 
we want, so k completes as much as possible, until the 
names start to differ, and it beeps to let us know that it 
couldn't finish the job. In this case, the names are the same 
up until the end of the word '^Applications", so that much 
gets filled in for us. In this case, that happens to be just 
what we want at this directory level. So we continue our 
quest to get a listing t)f /Applications/Utilkies/ by typing a 
little mure, until the line reads: 

Is /Appllcatiotvs/Util 


Wc can then j)ress Tab and the rest of the fine is filled out: 
Is/Applications/Utiilties/. from there, we just press Return and we 
finally see the listing of Terminal and tlie IJUlilicHS (which would 
make a great hand name, by the way). 

tneb:^] scottX Is /AppHcatlotis/tltilitles/ 


AirPort Adttiln Utility.app 
Keychain Access.app 
Mrectory Access.app 
Apple System Preflier.app 
Network Utility.app 
Disk Utility.app 
Audio HTDT Setup.app 
Print Center.app 
Earthlink 

Bluetooth Serial Utility.app 

Software Restore.app 

Installer.app 

CPU Monitor.app 

Terminal.app 

Java 

Console.app 


DigitalColor Meter.app 
AirPort Setup Asaislant.app 
Hetlnfo Kanabec.app 
Disk Copy.app 
Asia Testt Extras 
ODBC Admin.app 
Display Califarator.app 
Bluetooth File Exchange.app 
Froces.'; Viewer.app 
Grab.app 

Bluetooih Setup Assistant.app 
Stuffit Expander.app 
IntelliPoint Uninstaller.app 
CoiorSync Otiilty.app 
IPod 1.2.6 Updater 
Key Caps.app 


Wf'rf History 

The thoughtful shell keeps Hack of ail the commands 
you issue, just in case you ever need them again. If yott warn 
to repeat the last command you gave, just pre.ss the up- 
arrow. You'll .sec the previous eunutiand, along with all its 
Options and arguments, retyped on the command line. Press 
return to make it so. 

There's a lot more to this tdek. You can keep pressing 
up-arrow to gel older and older commands re.stored to the 
command line, all the way back to the start cjf your shell 


[nob: 


50 

14:41 

1,‘5 / 

51 

14:41 

cd X 

52 

14:41 

cd “ 

53 

14:41 

Is / 

54 

14:43 

Is “ 

55 

14:43 

Is / 

56 

14:51 

Is /Applications C Mac QS 9 

57 

14:53 

Is /ApplicatloneV \(Hac\ OSV 

18 

14:53 

Is 

59 

14:54 

Is /Library/ 

60 

14:54 

Is /Library/ 

61 

15:11 

Is /Library 

62 

15:14 

is /Applications/Utllltlcs/ 

63 

15:14 

Is /Applications/ 

64 

15:17 

Is /ApplicaTions/Utiiities/ 

65 

15:10 

man Is 

66 

15:19 

Is / 

67 

15:19 

Is /Applicetlons/lltillties/ 

63 

15:25 

history 

69 

15:30 

man history 

70 

15:30 

man history 

71 

15:30 

history 

72 

15:30 

history -a 

73 

15:31 

history -h 

;4 

15:31 

history r 

75 

15:33 

cat video 

76 

15:33 

set 

77 

15:34 

history 

78 

15:35 

history -30 

79 

J5:35 

history 30 


) /cleanup 


Wow, talk alK)ui Big Brother watching you! In this listing, 
we've actually usetl one of history's command line opiioas to 
limit its output to the last 30 cotnmands ratlier than showing the 
whole tedious sjk^w. The history command has several other 
interesting options, including -r to show^ the li.si in reverse order 
(oldest commands first), and various options for saving 
commands to files for easy recycling. 

T'lie history output is good for more than just amusement 
and quiet contemplatUm. Each line starts with a number, and 
you am repeat diat line’s command just by typing an 
exclamation point (which, if you want to be taken seriously as a 
Unix geek, you should call "bang") followed Ijy tlie line numi^er. 
Kor example, tr> repeal ilie conuTiand that history shows as line 
67, you am type 167 and press return. 

CR! USING IN COMI-URT 

As you do your Terminal business, you'll find yourself 
moving from one directory to another. You probably know tliat 
every active shell session has a uK^rkin^ directoiy, which is the 
directory that’s assumed (or commands if no directory is 
six^cified. For example, if you type Is without any argumcnis, 


42 


Mac: OS X: Wading In 


MacTkch • May 2003 







you'll get a listing of your working directory. You can fmd out 
ytjur working direaory by using the pwd working 

director)') cxjininantl. 

Whenever yoLi type a conunand lliat operates on a hie. you 
have two choices For how to specify the file's directory: ytnj can 
eitlier give a conipleie pathname to the file, or you can cliange 
your working directory* and then ccimmands wall look For files 
in that directory. Coinpare these two ways of deleting a file, 
using die shell cemimand rm (remove): 

m "■/Doc:Lin]OJits/Work/lnvoices/0ec02 .doc 

vs. 

c6 "/l^ociimeiitii/Wdrk/invoices/ 
rm CNic:02.d£Jc 

Both produce the same result* deleting the File 
E)ec02xloc. Changing workiitg directxnies is a good strategy 
if you're going to be living in that directory for awhile. It's 
also useful when you^re Just getting started with the shell* 
just to make sure youVe working in ihe directory ytni think 
you are. This is especially true if you're doing desimciive 
things like deleting Files. When you're just learning to find 
your w'ay around* you can add lo your Cf>mforr level by 
setting the working directory before Ofrerating on files. For 
furtlier coinforL, you can use Is after changing working 
directories as a sort of reality check that you’re in the right 
direcftvry. Don't wtirry about taking an extra step nr rw'O to 
make sure you're doing the right thing, especially before you 
do soinetliing dra.sLic like deleting file.s. 

Don't Forget: It’s a Mac 

Mac OS X is a rnarnage of the Mac and Unix* but a lot 
of folks tend lo forget that you can take advantage of 
siiindard Mac stuff when you're using TerminaL For example* 
you can open as many windows as you want. Ever)' window' 
is a separate shell session. This is useful if you have a shell 
session or two that's running a lengthy coniniand, but ytnt 
still want to be able if) interact with the shell for directory 
listings and so on. You can even use different shells in 
various windows. In Figure 1, we have tliree shell windows 
open* each running a different shell. As a Mac guy* a shell is 
pretty much a shell Lo me* bui 1 know^ that each one has its 
own quirks* charms, and accursed blcmislies* so you should 
choose the f)ne you like the best. 
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* TvrimlKiit JfdiR Sc/ChlltMdt Font Wirutow Help 



have some fiia with the mmpany Unix gotl wliu wants to try out 
your Mae. (For tx.'st results, combine this with the Desktop 
Preferences selling tliai clianges tlie desktop picture every 5 
seconds.) See Figure 2 to gel an idea of how diis IcKjks. 
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FijEfwre Huib shell window is ninnin^ii a dijfere}it shell: 
tcsh. hash, and zsb. 


Figure 2. Maylxf ibis is a little tm trnusparent. 


Copying anil pasting text works just dandy in Terminal 
wintlows. You can copy text in any applianion and pasie it into 
a shell window - the text appears at the insertion point. Drug 
and drop is another M;ic-like feature you can ii.se with the shell. 
You ran stdeci !exi in a window and drag it to the insimion 
tx)int, and tt will l>e inserted. 'Iliis w'orks wiiether the text etHiies 
from a Terminal w^inilow^ - even the same one as the destination 
- or another appliration. What's more - and this is really etx)l - 
if you drag a file from the Finder and dr<>p it into a .shell 
window, the tile's name appears at the insertion point. 
.Somebotly w'lis really think in' there! 

Of a)urse, pure fun is one of the Ix^si Macintosh features. 
Even tliough Terminal is perhaps Elie most utililariaru plain 
application you can imagine, iUs got some fun built in, Itxx One 
way to iiave a gorxl time with Temiina] is by customi/ing the 
appearajice of its window's, in Teiminal, cIkkjsc^ Terminal -> 
Winckwv ,Sellings, then pick Color from the Popup at the top of 
the tfiaiog. 'I'liis dialtjg lets you choose difierent c'f>lors for regular, 
IxJd, and selected text, the background, and the cursor. You can 
set color combinaiions that lire gaudy, bizaiTe, and completely 
illegible if that's your desire. For even more joy, user the 
Transparency slider to set how opaque you want the Tenntnal 
window to be. 1he more transpirent it gets, tlie more the window' 
tx*ne;iih it shines througli. Tills has a very liigh cool factor indeed, 
altliough it's easy to gt) a little overlxxtrd on the transparency. On 
the other hand, cranking up the transparency is a great w^ay to 


Gti Forfu and NERDm^ 

As you continue on ytjur way tow^ard mastering OS X, you 
can use the tips in ihis column and disctjver more of your own. 
Ibe more time you sfKiid in Tenuinah the more comfortable 
you'll fee*! drii ing att>Lmd. Rememlx^r that for some opcratitins, 
you have the option of working in the shell or in an Aqua 
appliaition. For example, when you need to create or edit a text 
file, you can use a Mac app like TextEdit or bBEdit, you can dive 
into a command line editor like Pico or vt, f>r you c’an switch 
Ixween all of the alxwe. Whkii is better? Thai depends largely 
on what you're comfortable w'ith. If you ctime from the Unix 
tradition, real live Unix editors are there for you. !f you're a Mac 
kinda person, you ('an use* apfis that are hmiiliar to you and you 
won't have to worry about learning vi commands unless you're 
lcx)kiiig for something interesting to do on a rainy day. 

During ytHir Terminal touring, you .should become gcxxJ 
friends with the man (manual) command, w^htch provides I milt- 
in dcK'umentaiion for sliell commands. To use it, type man 
folluw^ed by the comtnand you want to leam about, such as man 
Is or man rm. (Using man iKaisionally pnxiuces some fascinating 
commands, sucli as man set, man machine, man top, and even 
man man. Who says Unix has no sense of humor?) 

While you're ftK>ling witli Tenninal, try lots of saiff that you 
arad aix)ut in man pages, but lie careful about clianging tilings you 
didn't re:dly want to change. Play anxind, exf>er!nient, take it slow, 
and heyj let’s bt' careful out lltere - but don't forget to have hin! 
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^Without a doubtf the Premiere Resource Editor 
for the Mae OS A weatih of time-saving tools,** 

- MacUser Magazine Eddy Awards 

“A distinct improvement over Applets ResEdit f 
- MacTech Magazine 

**Euery Mac OS developer should own a copy of Resorcerer 

- Liumard RosenthoU Aladdin Systems 

“Without Resorcerer, our localization efforts would look like a 
Tower of BabeL Don't do product wUhoul Ur 

- Greg Galanos, CEO and President, Metrowerks 


“Resorcerer^s data template system is amazing. ” 

- Bill Goodman, author of Smaller Installer and Compact Pro 

“Resorcerer Rocks! Buy it^ you will NOT regret it,'* 

- Joe Zobkiw, author of A Friigment of Your Imagination 

“Resorcerer will pay for itself many times over in saved time and effort 

- Mac User review 

“The template that disassembles PICTs is awesomer 

- Bill Steinberg, autfuir of Pyro! and PB71 }oIh 

“Resorcerer proved indispensibte in its own creationr 

- Doug McKenna, authiw of Resorcerer 
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Standard price: $256 (decimal) 
Website price: $128 - $256 
(Educational, quantity, or 
other discounts available) 

Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 

Payment: Check, POs, or Visa/MC 
Taxes: Colorado customers only 

Extras (call, fax, or email us): 

COD, FedEx, UPS Blue/Rcd, 
International Shipping 

MATHEMiESTHETICS, INC. 

PC Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
Fax: (303) 440-0504 
resorcerer@mathemaosthetics. com 


• Very fast, HFS browser for viewing file tree of all volumes 

• Extensibility for new Resorcerer Apprentices (CFM plug-ins) 

• New AppleScript Dictionary <‘aete’) Apprentice Editor 

• MacOS 8 Appearance Manager-savvy Control Editor 

• FowerPlant text traits and menu command support 

• Complete AIFF sound file disassembly template 

• Big-, little-, and even mixed-endian template parsing 

• Auto-backup during file saves; folder attribute editing 

• Ships with PowerPC native, fat, and 68K versions 


• Fully supported; iPs easier, faster, and more productive than liesEdit 

• Safer memory-based, not disk-file-based, design and operation 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opens/marks/selects resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource files from simple Rez-like scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 

• Its own 32-bit List Mgr can open and edit very large data structures 

• Templates can pre^ and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Balloons, AppleEvent, GX, etc. 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, ietb^s, lists and popups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Relied on by thousands of Macintosh developers around the world 


lb order by credit card, or to get the late^ news, bug fixe^ updates, and apprentices, visit our website, 

www.mathemaesthetics.com 














SYSADMIN 


Hy Richard Patterson, Los Angeles, CA 

Configuring an Xserve as a Router 


A Case Study in System Administration 
for Digital Janitors 


An Xserve user experienc e 

Illusion Arts purchased an Xserve in Septeinl:>er 2002 after a 
very persuasive markeiing seminar by Apple. Generally when a 
new a>mpuler product Is introduced, some use^rs I'iiid it to lx* a 
cotnpletely'plug-and-play dream while others descend into a 
nether work! where everything that should work doesn't. Our 
experience with the Xser\^" has definitely lx*en of the surreal 
variety, atid 1 atn tempted to chronicle ilie whole nightmare so 
that the reader is forced to sohinit to the s;ime initiation ritual 1 
endured; l:tut this is not tlie place lor tliat. What 1 am hoping to 
accomplisfi here is to hatvest the fat it tn a way thai spates at 
least one other person from leaving lu negotiate tlie maze and 
permits him or her to gel on with life. 

The kitchen sink 

Illusion Arts i.s a small visual elTects facility with alxiut 20 
employees wliith was spun off from the Universal Studios Matte 
Depamneni in We use Macs for painiing and compositing 
and for some 30 work. We also use Windows computers to run 
30, tracking and other image pnxessing uk>1s that do not exist 
on the Mac. For years we relied on sneakemet to move data 
througli the facility, but in 2tJ00 we centralizetl our storage with 
a Sun server. We boughl an Xser\^e for a variety of rea,sons, and 
it had i(j fit into a netw^ork comaming the following components: 

1) A Sim 450 with a 1.5 terabyte IlAIl.) serving files to Macs and 
Windows workstations and twelve Frhernet pons including 
two filler and one copper gigabit |k>i1s. 

2) A 48 port 100 baseT .switch with a dual filx^r gigabii uplink 
to the Hun. 

3) About 30 Mac workstations running OS 9.2 

4) 5 Windows 2000 workstations 

5) 8 Mac:s on a renderfanu 


6) 12 Windows 2000 render comfiuters 

7) A 24 port 100 base! switch with a copper gigabii uplink 

8) A Col>alL Qul>e internet gateway, email and web|>age server 

We ordered a fiber gigabii Ethernet carti for the Xserve 
with the idea that it could connect to tlie rest of the network 
via one of the uplinks on the 48-pori switch. This could have 
been replaced by a converter to go from copper to fiber 
gigabit; but I originally thought the fiber card could l)e 
ordered instead of a second copper card, and 1 had trouble 
finding the converter. We ordered the Xserver with two 
copper Fthernet cards just Ixfcause it was faster to gel the off 
the shelf configuration rather than a “custom build." 
Theoretically the .second copper gigabit card in the Xserve is 
redundant. We have used it for a direct connection to ihe 
Sun, which may have some pedagogical value as a example 
of dealing with netw'ork connections. We ended up getting a 
copper to filler convener as well in order to set up ihc 
network the way we finally decided we wanted it. By the 
time 1 was done 1 found myself purchasing a 12-port gigabit 
switch so that I could reconfigure everything again. The first 
moral of my story is that it is more economical to know what 
you w^ani to do and what is possible to do IxTure you start 
buying coniponenrs. 

Originally both the gigalnl uplinks on the 48-pori switch 
had been used to connect to the Hun as a means of balancing 
the load, but several people had told me that this was 
probably unnecessary. The bottleneck, if there was one, 
would noi l>e in ihe uplink connection to the Hun or in the 
gigaf)ii card in the Sun. 

The PLUMBiNri 

OH 10.2 Herver does not have a graphical user interface 
for configuring the Xserve as a router or a bridge or a 
gateway. Perhaps by the time anyone reads this a future 
release of the system software will provide an easy, intuitive 
graphical interface for setting uj> an Xserve to do what we 
wanted ro do. For now, however, it is necessary to pretend 


Richard Patterson is in diarge of digital imaging al Llkisiun Arts, a visual effects facility in Van Nuys, CA, s]>edalizing in matte paintings and blaescreen 
compositing for movies. Y«hi can mach him at ncharcl@illusion-arts.Com, 
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that you are a UNIX .sysLcm administrator to make it work. 
The i>cst lime to do this is when you first gee your Xserve and 
are game to reinstall the system frotn scrait h If anything gels 
screwed up. In fact I might recommend rcdnstalling the 
system a t'ouple of time just for the hell of it so that you feel 
completely free to mess up anything and everything with an 
inadvertent comtnand. Don't let a scasemed system 
administrator put the fear of God in you witli stories about 
how novices typing in the command line can cake an entire 
system down for ilie count, just do it. 

How much do you need to understand alKsut TCIVIP 
networks in order to set up an Xserve with more than one 
Fthernet card? If T liescnhe the steps well enough you may 
not have to understand anything at all, but 1 always think an 
exf>erienc:e is much more enjoyable if J feel 1 liiiderstood 
something about w\m happened. So my answer to the 
cfuestion i.s^ "f-nougli to feel satisfied.” 1 shall iry to include 
tlie amount of contextual information that it lakes to satisfy 
me and indicaie ihe areas wdicrc I am still unsatisfied. 

First and foremosi if is helpful to understand something 
about an IP address. I first accepted IP addresses into my life 
when I had to set up a m<Klem connection to an internet 
service provider. They gave me IP addresses to enter like a 
phone number and 1 tried to write them down .somewhere 1 
could remember so that f could .set the modem up again 
every^ time I re-installed the system. An IP address is very 
much like a phone number. It is actually a string of 32 bits, 


wiiich for the sake of convenience are broken up into 4 
groups of 8 l)iis and referred to by the decimal equivalent of 
each 8 bit group. The notational convention uses a to 
se[)araLe each portion as in 172.1.2.203. If ail the bits were 
set to 1 the result would be 255.2S5.255.255. 

Kach portion of the IP address ha.s a different 
significance just like the area code, exchange and number 
function differently in a [ihone number. There are 
convenuofis and rules governing the use of various ranges of 
numbers which need not concern us here. I am going to 
assume that the reader already has some IP addresses in play 
on his network. The two portions of the IP address that 
matter to us are the last two numbers. The next to last 
mimfier can be thought of as crimparabie to the exchange 
portion of a lelephone number, il am ^imng away my age 
bere\ perhaps, by referring to the first three monhers in an 
American phone number as the *‘exbange." fn my day, Kid, 
phone numbers started with things like Alpine 2, which was 
dialed as AL2 and eventually just became 252,} In the IP 
address 172.T5.203 the 5 can generally be taken as 
specifying Ihe "subnet.” 

Actually it is pntbably the use of the mask which defines 
Ihe subnet. {Please note that whenever I use an qualifier like 
^probably"' or "generaliy'* w'e ham entered an area where my 
understanding of things is less than totally satvifying^ but I am 
not letting that stop me.) The mask is usually specified as 
255.255.255.0. This indicates a siring of bits where the first 
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24 are i’s and \hv bsi 8 aa" O's. A ma,sk fiinaiuas a.s a sieve 
and only lets things through where there are holes, i.e. 
zeroes. It is used to separalc the portion of the 11^ address 
which defines the individual device that to which the message 
is addressed from the rest of the address which function like 
an area cxKie and exchange to define networks and subnets. 
With a private netwt>rk like ours the easiest way to create 
subnets is by using a mask of 25S.251.255-0 and letting ihe 
third “{>ctet" specify the subnet as in 172J.Lx, I72,b2.x, etc. 
This permits each subnet to have 214 unitiue addresses. 
(Zero or 215 cannot be used for a device as they are reserv^ed 
for other purposes.) .Siihneis can he used by creating by 
masks with more than 24 ones as in 211.211.211.192 which 
has 26 ones followed by six zeros. Tliis is useful in many 
cases but requires more effort to determine which subnet a 
particular address will lie in. In this case the two extra ones 
mean that there are four different possible networks having 
172JJ as their first three numbers. The resiili is that 
172.1.1.62 is in a different subnet from 172.1.1.66 and you can 
not u.se the addresses of 172,1.1.63 or 172.1.1.64, because 
they become the e<|uivalent of 0 and 211. If you really want 
to understand this 1 suggest you pursue it later via Microsoft 
Knowledge liase Article #164011 or any nu[iit>er of other 
discussions ofTClVlP addressing. 

A mask of 211.211.211.0 applied to an address of 
172.1.1.203 tells the system that 203 is ihe unique part of the 
address. Another notation used to refer to ii mask like this is 
24/0 as in 172.1.1 24/0. The 24/0 means the mask has 24 I's 
and the rest (fs. There are times when this is a more 
convenient way to specify the mask, but we are not going 
there rigiil now. 

We now know enougli to encrHinter our first ob.slacle (or 
opportunity lor uchievemeni if ytm prefer). Two Ethernet 
ports in one computer are not generally happy if they 
live in the same subnet. There may very well be numerous 
exceptions to tins or ways to avoid it altogether, but for the 
purposes of ihb exercise it is being awarded the status i>f Fact 
Of Life. We are also going to simplify life by dec laring the 
subnet to l>e defined by the next to last jKjrtion of the IP 
address. 1 got used to this idea when the experts who .set up 
our Sun server loaded it up with 12 I* t her net ports and we 
had 12 different subnets. In the Chooser on a Mac 
workstation this produced 12 '‘Zones," With Appletalk a 
subnet iK'comes a Zone, but l)eware of using the term “zone" 
when ytai are discussing your problem with an lunicst-to-god 
UNIX or Microsoft System Administrator, lie or she will 
probably not know what the tc^rm means and tmly think you 
are demonstmting your ignorance or confusion. 

IP addresses can he static or dynamic. A static IP 
address is manually assigned to the com [niter or device and 
it stays the same until a human being changes it. A dynamic 
address is assigned by another device **00 the fly** .such that 
the human being never needs to care what the current iP 
address is. As enticing as this stjunds, I have had no truck 


with dynatnic IP atidresses. Our network is .small enough 
that it is feasible for us to assign and keep track of IP 
addre.sses. I liave also been under the impression that some 
of llie devices on which we depended, depend in turn on 
static IP addresses. This discussion is limited to a 
network based on static IP addresses. 

OS 10.2 Server does have a graphical interface for assigning 
IP addresses to the hiiieniet cards installed in your Xserve. Even 
if you intend to run yoitr Xsetv'e without a monitor and 
keylniard attached to it, I strongly recommend tliat you 
temporarily pui a irionitor and keTlxyard un it until you are 
.Siitisfietl that it is functioning properly, 1 do not even know if it 
is po,ssible to install (or re-insLill) tlie operating system without 
a monitor and keyfK)ard, and I have never lx.-en tempted to finti 
out. 1 am reasonably certain it is possible to as.sign IP addresses 
lo Ethernet cards by logging in remotely, hut it is (eriainly easier 
to do via the graphical interface. The Network system 
preference panel lets you assign the IP address to each carc:l just 
as yoit can assign an IP addre.ss to any work,staritjn in System 9 
or 10. If you have more tlian one card installed there should 
lx* a poll down menu allowing yon to .select the card you want 
tf) configure. 



With our Xserve I initially u.sed IP addresses of 172.1.2.4, 
172.1.3,4 and 172.1.4.4 for the three Hthernet card.s. The 
172.1 is inherited from our exi.sting network configunition. 
Sinc'e this is an internal network which is not visil>le (we 
liope) lo Ihe internet, we are free to use whatever range of 
IP addresses feel.s gtnid. I have no idea why 172.Lx.x was 
chosen by the vendor who set up our server, but t see no 
reason to change it. I chose the subnets based on llie fact 
that the majority of our facility had been using IP addresses 
of 172.1,1.x and 172.L2,x. 4he 48 port switch to which most 


48 


CONI'IOllMrNG AN .AS A RqUTI^H 


MacTech • M ay 2003 
















of our worksiaiions wt^re ritlarhed was set up witli half of the 
ports in ?.c)ne 1 and Inilf in Zone 2. Since 1 was stealing ifie 
second gigafnf uplink, my plan was to put all of tlic 
workstations in Zone I and connect the Xserve to the second 
gigabit uplink. 

1 shall descril>e later how I tiad to reconfigure the 
switch, but for now the important point is that putting three 
Ethernet cards in an Xserve and giving them the IP addresses 
1 did created three sub-nets that did not automaiiailly 
connect with each other even though they shared the same 
bed. The Xserve itself could communicate with any device 
attaclied to each of the cards, but a computer at 172.1.2.27 
(attached to the third card in the X.serv'e) could not 
communicate witli a computer at 172.1.3.27 (aitat'hed lo the 
first card), lb make this happen we must conOgure the 
Xserve as a njuier. 

lire first thing to do is enable IP Ibrwarding. IP forwarding 
apparently does exactly whai it sounds like it should do. IP 
packets arriving via one Ivthernet card are pa.ssed along Ui the 
networks connected to the other Ethernet card(s). t iK^lieve IP 
forwarding by itself will only Ibrward packets to a card with an 
address wliose subnet matches that of the address to which the 
packet is lieing sent. If there are additional subnets bninching 
off downstream somewhere, additional routing coiifiguniiinns 
are required. 

With OS X i(K2 SefV'er LF forwarding is turned off by 
defaulE. 1 think in earlier versions it imy have been on by 
default. This would at least explain w^hy some users felt some 
functionality had gone hiding with the release of 10.2. If 11^ 
foiv\ardiiig is off, nothing auached to one Ethernet card will Ik* 
able lo communicate w'iih anyliiing attached to the second 
Ethernet card. Enabling IP ibiwarding is mcessiify but not 
always sufficient to make this happen. De^ximding rm the 
cxjmplexity of your netwr^rk Jl may be that the only other 
necess;try step is lo set the default router on your workstations 
to the IP address of the Ethernet card in the Xserve to which it 
is amnected. 

Tlicre is a system file called lK>sLconfig which tells your 
Xserve whether or nol to enable IP forwarding when it starts up. 
n is a text file but it is normally hidden from view. The easiest 
way to inspect the file is via the Tcnninal window. Oj>en tlie 
Termiruil, and type cal /etc/hostconfig. 

lathena;^] acimjr% cat /etc/hostconfig 


n /etc/hostconfii 

H 

# This file is maintained by the systeii control panels 

§ Network tonfiguratIon 

HOSTNAME»athena 

ROUTEK=-AWTOMATrC 

t Services 
AFPSERVER-ND- 
APPLmU“-HULTIHOKE - 
AUTIISESVER—NO- 
AUTOHOUNT-'YES- 
UONFIISSERVER^ NO 
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Macworld CreativePro Conference & Expo is a unique series of conferences, focused on 
technology for the creative arts, including design and publishing, video and music. 

Designed for creative professionals and prosumers — everyone who wants to immerse 
themselves in the creative arts — it's the answer to the creative community's demand 
for new insights. 



Register online with Priority Code: A-MTM 


Level 1 & 2 Conference sessions 
will cover topics such as: 


1 & 2-Day Tutorials focus 
on topics such as: 

I DVD Studio Pro 
I Mastering Digital Photography 
I Intermediate Dreamweaver 
I Desktop Publishing 
I QuarkXPress 
I Photoshop 
iMacOSX 


I Professional & Prosumer Video 
I Expert Design 
I Advanced PDF 
I Preflighting 
I Flash 

I Color Management 


i Editing Techniques for 
Final Cut Pro, Final Cut Express 
and iMovie 

I How to Set Up a Home 
Recording Studio 

I Music Editing on Your Mac 


















GUPS'-YES- 
TPFORWARDTNG^'NO- 
iFV6= VRS- 
HAILSKRVER"= NO 
HETBOOTSEKVER- ?JO- 
HETINFOSERVEk^ ALITOI^ATIC - 
N 1 SDOMA 1 K=-NO- 
RPCSERVER"" ■ AUTOMATl C 
TTMESYMC=-NO- 
QTSSKRVER=-¥EE“ 

SSJ]SKRVRR=-VES- 
SHEEERVEtt—WO- 
BNSSERVM-^ NO 
SERVERMANA(JSRSRRYKR=-YES- 
WATCRDOGTIMER- YRS 
MANAGEMENTSBHVER=-NO 
LDAPSERVER='¥E$’ 

APPUETALK HOSTMAME=athena 
[aihena:-"] admin?^ 

Note the line that s^ys 1PF0RWA1U)1NG-N0-. This is 
telling the Xserve not to enable IP forwarding and Is the 
default state when the machine is shipped. What you need 
U) do is change that line ho that it says IPFORWARDING =- 
Yl'S-, Unfonunately you can not do this in the display 
prtxluced by the cat cooimand. Cal (wliich 1 believe is short 
for concatenate) is one of several ways to view the cxintents 
of a text file; hut it is only a display of the contents and not 
a means of clianging them and saving the result. There are 
lext editors built into UNIX designed For this task, but tliey 
are non-intuitive in ilie extreme. Proficiency in, and a 
preference for, one of these editors is a sign of a true Initiate. 
Fonunately for the rest of ns wlio do not have time tc) play 
this game, there is BREdil Lite, the free version of Bare Bones 
Text Editing software. Version 6,1 which includes an OS-X 
version can be downloaded fnma vvww,barehunes.com. I[ is 
an invaluable tool, w'hich also helps in moving lext files 
between Mac and Windows operating sysiems. 

Willi BBEciit you can seleca Hidden Files from the File menu 
and you will .see all of I he sysiem directories and files. The etc 
directory is on the j-oot level and contains hostconfig. You can 
open it, edit ii and save it just like you would expect to lie able 
to do. it may he wise to save a backu[:» version of it liefore you 
save your edited versicjn. Creating a file called 
hosiconfig.hackup will not confuse the operating system. If you 
run into pennissioas problems when you try lo save it, 
logging in as rcxit and editing the hie, 

Once you have saved the version of hostconfig 
containing the line 1PFC^KWARD1NC--YES-, the computer 
will alw'ays enable IP forwarding when it starts up until you 
rc-edii this file. To enable 11^ forwarding now, you must 
restart the computer. 

After you restart you c an verify that IP foiwarding has in fact 
been enalilecl by entering the command syscil -a in Uie terminal 
window. You will get liack a long list a variable settings 
including one line which says nei.inet.ip.forwarding: 1. if it says 
net.inet.ip.lbrwarding: 0, then IP forwxirding has not l>een 
enabled for some rcxison. So long as you use the -a flag with 
the command, sysdl will not change anything alx)ut the way 
your system is configured. 


To avoid having to look through the long list of variables 
you can use grep to have it show only you what you are 
interested in. Using the | to Ate output of one command 

through another is one of the essential trickLS to using the 
command line. Tlie grep command is equally essential. It 
extracts from a flocxl of text only the lines containing the word 
or \’haracter string” you tell it you are loc^king for. 

[atheiia:^ adniin% sysctl -s. \ grep ip. forwarding 
net.inet.Ip,forwarding: 1 
fathena;“j adminX 

Once you know IP forw^arding is enabled, make sure die 
computers connected to your Kserve are set up with die IF 
address of the right Ethernet atrd in the Xserve as its router. 
With OS-X this is done in the Neiwoi'k Preferences panel 
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Note that the workstation's IP address and the Router IP 
address must be in the same sub-net. In this exam]>le they 
both Ix'gin wiih 172.J.1. If 172.1,1.3 were the address of one 
of the Ellieniet cards in my Xsei-ve IP fonvarding would 
ena!>le me to connect to any other computer attached to the 
Xseive provided lhai computer is in the same subnet as the 
Ethernet card to which it is attached. Without IP forw^arcling 
in die Xserve I would only be al>le to see compuiers in my 
own 172.1 J .subnet. 

If you have turned on 11^ fowarding and set the router 
address on your wwksrarions and you discover that 
everybody connect to everybody else, declare victory and 
quit the field. 

If life is not so simple, the first thing to do is gf> to 
workstatiems and see if you can ping a workstalUm on 
another subnet. Ping is a command lound in UNIX and 
Window.s alike which sends a signal out to the IP ackire.ss 
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you Npccffy and reque.srii a response. If a response conics 
back it tells you how long it look; if no response comes 
back, you still have a problem. OS-X has a nice Network 
Utility (found in the Utilities sub-directory under 
Applications) which will ping and also do a trace route. A 
iraceroiite sends out a message to an tP address and reports 
l>ack the address of each step it has to take along the way. 
In our example a computer at 172.L5.201 attempting to 
connect to a compiitcr at 172.1.2.35 will rep<in that it first 
went to 172.L3.4 and then found 172dJ.35. In oilier words 
172. L 3.201 is connected to one card in the Xserve with an 
address ol 172J..3.-1 and tlie message is forwarded to the card 
with the address of 172.L2.4 which is in turn connected ro 
die computer at 172.1.2,35. ( he two cards in the Xserve arc 
considered one “hop" along the way. 

If you are unable to ping computers on otlier subnets, it is 
possible you need to clean up the routing table in die XServe or 
to exfiliciiiy add routes to it. Using the Network Utility select the 
Nctstai tail and check the Display Routing Table Information 
buiion. This is the equivalent of entering the neistai -r 
cot lima nd in ihe terminal window. 1 liiive found that die Netstal 
function in the Network Utility can take a long time to display 
anything if you have just recently relxHrted. If it seem.s not to 
\x: working, use the command line netstat -r whicfi Ls geiiLTally 
more res|wnsive. 
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Most of wlvii it shows you is the routing table that has l>ccn 
generated as a result of configumiirin settings and activity that 
has actually taken place. Tlie table seems to divide into two 
.sections, and 1 know nothing about the section labeled 
InternetC). I do not believe it is relevant Lo this discussion. Most 
of the first pan of the table is dear enough. 

The Destinatirin is the IP address or the range of IP address 
to which a message may 1^ sent. Don i a-sk me alx>ut the 
169,254 and don’t worry about it. 1 wasted a fair amount of time 
worrying alx>ul it and even trying to remove it from the routing 
table until I noticed that it is always there and docs nothing to 
get in my way. Itiings like that are best left alone. 

1^’alho.st is a name for the computer in which this table 
resides. Since computers have evolved like human lx.4iigs to 
the point where they like and even need lo talk lo tliemselves, 
there is a lor)pback rtmle in wliich ilie localhost arrives at itself 
by using itself as tlie Gateway. 

The Gatew^ay is the what you have to Ik' routed ilirough in 
order to connect with your destination. The three Ethernet airds 
show up here as link^i, link#5 and liiik#6 and are listed as the 
Gateways for die subnets attached to them. In oilier words if 
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you want to get to any address beginning with 172.1.2 you go 
through link^i, 

The Netif is, i Wieve, the network interface or the mime by 
which the Xserv'e knows ihe physitral devices. In this case enO, enl 
and en2 are the thret^ Ediemet oiids and loO is the Xserve itself. 

The Flags are shordiand indications of dungs alxjut die 
routes and even the definitive b<x>k t>n TCP/IP says they are of 
only marginal value, ft is comforting to know that the U means 
the mute is uj) and operational, but the chants are good that it 
would not be in the table at all if it were not. The Refs, Use and 
Expire information is t>f no relevance to this discussion. 

The reason to lcx)k at the routing table is lo peruse the 
destinations and gateways. If a connexion has been made to a 
specific computer or device, the mudng table may store its MAC 
or hardware address instead of its IP address. You can be happy 
they are connected and move on. What you are ]tK?king for is 
whether there is an appropriate route for each subnet and 
whether there are contradictory or conflicting routes. 'Tliere 
should only be one routing siatement for eac:h subnet. Tlie 
subnet statements are die ones witli tlie Destinations tike 
172.1.2/24. This means any IP address beginning widi 172.1.2. 
If for some reason diea^ are two routes for a given .subnet, tlien 
remove one using the route command. 

rontG delete 172.1.1/24 172.1.2,1 

This command would delete the route for subnet 172.1.1 
but not just any luser is allowed lo issue commands like this The 
.sure.Hi way lo achieve this goal is to log into the server as rcxit, 
in wliich case you can be certain the Xserve will attend Ui your 
eveiy command. You may also be able to use the siido 
command to make the X.scrve pay attention. Sudo stands for 
“supeniscr do" or ‘'I am the super user, do what 1 tell you." 

sudo route delete 172.1,1/24 1/2,1,2.3 

Any route you remove, you can also resUire with die route 
command. 

fiUdo route add 172.1.1 /24 172.1 .7..3 

Thi,s is how I manually added the mute to the table listed 
above. The. reason I did so and the reason 1 also changed iltc 
delauli route by deleting the original default route and adding 
the revised one is that 1 have a .switch at 172.1.2.3. Most of the 
computers at lac lied to this switch have addres.ses Ix^ginning 
172.1.1 and die Sun server with the RAID is at 172.1.1.2. This 
switch is also the imermtxliate connection to the Quf>e and the 
DSL modem through w^iich w^e access the iniernei. Setting the 
default r<jute to this switch enables computers aitac:fied to die 
Xserve to find their way to die internet. 

4'he default route is the route assigned to any incoming 
message with a desiiaaiion for which there is no explicit 
routing instruction. 

Fortunately for me the .switch at 172.1.2.3 is a “managed" 
switch. That is lo say it has software in it which enables it 
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to be configured to function in a variety of ways. One of 
the ways it can he .sei up is to have pons assigned to 
different subnets. The technospcak for tins is a virtual local 
area network or VLAN. Generally a managed switch these 
Jays will liave a user interface which can he accessed wiili a 
weh browser via TCP/IP. In the case of ilie Kxtrente switch 
it is a very simple matter to assign ports to VLANs. Tit is 
enables rny switclt to function as a router us well as the 
Xserve. 1 was able to reassign all the ports that had been 
connected to computers with IP addresses putting them in 
Zone 2 to liie VLAN for Zone 1 and then change the IP 
addresses on tlic worksiattons from 172,1.2.x to 172, L 1.x. 1 
left only two ports assigned to Zone 2, llie gigabit uplink 
which was now connected to the Xserve and one lonely port 
for the wtjrkstuiion w^hich is serving a PileMaker Pro database 
filled with scripts referencing the IP address of the dataha.se 
server. {This is the kind of thing that makes life so exciting 
for wunnal)e System AdministratorsJ 

At this point I myself am going to declare victory and 
quit the field with only a few more parting shots. When 1 
began the odyssey that led to all this wisdom, I had many 
people tell me that 1 had to use NAT or IPFW to do what 1 
wanted. Some recommended using a piece of iliird party 
softw'are call Brickhouse to make the job less painful. Even 
the highest lever of support at Apple had me convinced that 
I had to use the routed (pronounced ""rouL-dcc”) command to 
activate the routing daemon. 'Lhe actual solution turned out 
to be much simpler than many people thought, and in 
retrospect I am still puzzled l>y wliy I had such a hard rime 
fjgtiring out what 1 needed to do and making it work. NAT 
is network addru.ss translation. 'I’he need for it assumes that 
there is routing going cm, but ks real function is to change 
the IP address that is visible in the message downstream for 
security reasoas. IPFW has m do with setting up and 
maintaining a firewall. It als<] assumes routing is going on. 
Presumably the steps required to implement NAT or IPFW 
will also make ihe Xserve function as a router, but they arc 
not the simplest way to make ii route. The big breakthrough 
that occurred when 1 learned how to aciivate the routing 
daemon using routed, now appears in retrospect to me to 
have been an illusion l)ased on the fad that entries in the 
routing table had really salved ihe problem. I believe that 
OS-X Server has built into it the intelligence to use its version 
of the route daemon whenever T? Forwarding is turned on 
and there is more than one Ethernet card installed. The only 
thing 1 have not figured out is how to script the necessary 
entries in the routing table so that they are added 
automatically every time the Xserve restarts. (Contrary to a 
prevalent myth, we find that OS-X and OS-X Server often 
reach an impasse that requires resrariing the computer.) 
Since it is possilde to paste text into the command line in the 
Terminal window, we have a Stickles note containing the 
necessary commands w^hich we copy and paste after the 
system restarts. 
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QUICKDRAW 3D 




APPLESCRIPT 


By Tom Djajadiningral. 


3D For Free Using the Mac's Standard Apps 


Converting raw 3D textfUes to QuickDraw 
3D's 3DMFformat using AppleScript 


we am mtike a droplui: u scnpi wliich pei’foriTis certain actions 
on tkx'umonts wIiIlIi are dropped on to It. 'Diis allows us to 
convert multiple files with the ease of and drop. 


SlfMMARY 

This article introduces you to the I basics of 31) fifes in 
general and the iD Metafile QuickDraw Myn native 3D 

iorniat, In panicular. U shows how you can use AppleScript lo 
easily convert a raw 3D text file into a 3DMF readable by tlie 
QuickDraw^ 3D Viewer or any other QuickDraw 3D compatible 
application. With this knowledge you c-an make liand-WTitten 
(.lata or data exported t?y a spreadsheet or dataha.se application 
suitable for visuafisation ns standalone 51 ^ models. 


QuickDicxw 3D's 3DMF Format 

3D models can lx? clescrilxxl using vertices and faces, A 
vertex b a point in 3D space described by x, y and z co¬ 
ordinates. A face is a fiolygon of which each corner point is a 
vertex. To prevent unpredictable resiilt.s a face shoukl l>c planar: 
all its vertices shoukl lie in one plane. Figure 1 stiows a technical 
sketch of a table whicli t'onsists of a square face (the table top) 
and eight triangular faces (the legs). Figure 2 shows the 
curres|KJiKlitig 3D mtxlel in the QuickDntvv 3D Viewer. 


iNTKOnilCTION 

The combined power of the suite of goodies tliat conies 
standard with your Mac is really (|uite amazing. One such gtKxly 
Is the QuickDraw 3D Viewer. Tlic QuickDraw 3D Viewer makes 
it p(5ssible to do Irasic viewing of 3D nHKlels that are fonnaitcd 
as 3D Metafiles (3DMf), QuickDraw 3D’s native file Ibnnat. 
Since the QuickDraw 3D Viewer is su[)puned by Simple text, 
which comes standard with a Mac, files written in 3DMK format 
can be viewed on any l^owerMacinrosh running QuickDraw^ 3D. 
Maybe you woukl like to visualise your spreadsheet or database 
(lain as HSiandaltjne 3D iiKKlels or perhaps you would like to 
write your own low -polygon count nxxlcls by hand ratlicr liian 
use a 3D mcxieller. To achieve this you could make the 
spreadsheet or database application export complete 3DMFs. 
Often though it is quite aw'kward to get the formatting right. And 
though it is possible to write complete 3DMlb by hand, you of 
course want to reduce re|xiiiive chores, stich as adding hr^ickeis, 
to save time anti reduce errors. Here we take the appnxich of 
writing minimalist tc 3D files w^hich are then ]MJSt-prtx'e.ssed into 
3DMP. So I low do we do ifiis [X jst-prtxessing? Enter two other 
Macintosh standard gtxxlies: AppleScript and ihe ScripiAlaker 
application. Althougli it is sektom o.sed for liiis express purpose, 
AppleScript is actually cfuile gtxxl at reading and writing text 
files. Another nice reaiure of AppleScripi is the ease with which 
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Figure /: Technical skc^ich of a fahie 


While walking alx>ut on the Geneva MtJlorShow, Tom .spotted a.[ap;inese concept car m which a iiisf>lay clearly showed a Macintosh alert bf>x with 
m errtjr of Type 2. As lie dews not find the pmspeci of liaving to install and configure Dnux for car navigation, c;ir audits and engine management 
particularly appeiiling, he can'I wail for rht: relcMse of OSX. 
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Figure 2t Jhe 30 model in the QuickDraw 30 Vimifer 


Listing 1 shows a 31^MF file for this lalilu. For our 
example we use the QuickDraw 3D mesh geometry, which is 
probably tlie easiesl to understand way to describe a 3D 
model. The liash sign (.^) marks a comment in a 3DMF. 
Everything on a line after a hash is ignored. Tlie 3DMF' here 
consists of two pans. Tfie first part Is the header, 3DMetafile ( 
1 6 Normal too ). The second part is formed by a coniainer 
which contains a single mesh object. Let’s look at the header 
first. The header, formetl by the first line of the file, tells us 
that we have a 3D Metafile for QuickDraw 3D T6. The major 
version number is 1 and the minor version number is 6. Tire 
third field, Normal, is the type of 3D Mciafilc. The fourth field 
of the header, too, is a file pointer to a table of contents 
which is non-existent in this 3DMF. Don't worry about the 
type of 3D Metafile and the table of contents paranielers. You 
do not need to know their exact iiieaning to understand this 
article and later we explain where to read up on the full 
3DMF specification, 

Listing 1: a 3DMF file 

tiihic.^df 

^DMetaflle ( 1 & Normal toc> ) 

in n isihie with a sqmK Top and four le|^s 
Container ( 

MeshC 

20 B^number of vtriictfs 
i 1.5 -1 #0 
-] K5 -1 
] 1,5 1 #2 
1 1.5 1 #3 
10 1#^ 

0.9 1.5 0,6 #5 
0.9 1.5 0*9 #5 
0.6 1.5 0*9 §7 
i 0 -1 #8 
D.6 1.5 -0.9 ih 
0.9 1.5 0.9 //lO 

0,9 1.5 -0,6 #11 
‘1 0 -I #12 
'0.9 1*5 -0.6 #13 
-0.9 1.5 -0.9 #14 
-0*6 1*5 -0.9 #15 
-101 #16 


0.6 1 .5 0.9 |17 
0.9 1.5 0.9 #18 
-0.9 1.5 0.6 #19 
9 #nunibcr of fiiccs 
0 ^nimibtr of contours 
0 1 2 3 fro 
3 4 5 6 frl 
3 4 6 7 fr2 
3 8 9 10 #3 
3 6 10 II fr4 
3 12 13 14 #5 
3 12 14 15 #6 
3 16 17 18 #7 
3 16 18 19 frS 

) 

Container [ 

AttrihuteS&t C ) 

DiffuseColor (1.0 1.0 0.0) *#rgb 

) 

) 

Nnw let’s look at wliat takes place within the bracket of 
the container, I'lie container contains a mesh and another 
container with a diffuse colour aiLril>ute in it. First the mesh 
description li.sLs the numloer of vertices involved* In our c:ase 
there are twenty vertices. What follows is a list of vertices 
which QuickDraw 3D sees as numbered from 0 to 19. Each 
vertex is descrilied by llirce co-ordinates. For example^ vertex 
numlier 0 lia.s tlie co-ordinates x=l, y=l.'S and 7=-l. Next is the 
number of faces, eight in this aise, followed liy the number of 
contours. A contour is a pt)lygtml hole in a face. Since there 
are no holes in our table the number of contours is 0. Tlie 
mesli description finishes with the eight faces* The first number 
of a face description i.s the ntiml>er of vertices involved in the 
face, the remaining numbers specify these vertices* For 
example, the square table top is face number 0, which has four 
comers formed by the vertices 0, 1, 2 and ,1 Finally, there is a 
diffuse colour attrilmle which applies to the whole mesh. It Ls 
.specified in red, green and blue components, each ranging 
fnim 0.0 to 1.0. 

Tim RAW 3I> FILE 

It is very important to carefully consider what the raw 
3D file should look like before you start writing a script to 
convert ii to 30MF. If you yourself export the file or write it 
by liand you are of course in compleie control. If someone 
else does this for you—say an expert in low-polygon count 
models—yoti want to make sure this person formats the file 
in such a way that makes life as easy on you as possible. On 
the other hand, you may wish to respect this person's way 
of formauing files. Listing 2 show.s an example of what a 
raw^ 3D file might look like. 'J'here are some differences 
between this raw 3D file and the 3DMF file we just discussed 
which make conversion pretty awkward, but it is 
under.siandal>le why the formatting of the raw 3D file is 
convenient for the person who wTites the file by hand. 
Because of the vertex and face lalreLs on each line it is 
immediately clear whether one is in the vertices or faces 
section when quickly scrolling through the file* Because of 
the commas ii is possible to pul spacc.s between a minus 
sign and a co-ordinate so dial the minus signs line up 
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vertically. Tliis makes it easier to spot co-ordinates with the 
wrong sign. Botli vertices and faces start rather than end 
with their index number so that the indices line u[) loo, A 
face line docs m)t include the number of vertices which 
saves work and reduces errors. Careful deliberation with all 
involved can safe much work and frustration. 
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listing 2; A raw 3D file _ 

t)escriptjt>n:This h a table with a w|iiarc top aiul four fcgs 


Vertices-20 


Vertex: 0. 

I. 1.6. 

■1 

Vortex: 1. 

1. l.b, ' 

1 

Vertex; 2. 

-1. 

1 

Vertex: 3. 

i. 1.5. 

1 

Vertex: 4, 

1. 0, 

1 

Vertex: 5. 

0.9. 1.5. 

0.6 

Vertex: 6, 

0.9. LS. 

0.9 

Vertex: ? . 

0.6. Lb. 

0.9 

Vertex: B. 

1. 0. 

-1 

Vertex: 9. 

0.6. L5. 

*0.9 

Vertex:10. 

0.9, L5. 

-0.9 

Vertex:11. 

0.9. 1.5. 

-0.6 

Vertex:12. 

-1. 0. 

1 

Vertex:13. 

0.9. 1,5. 

-0,6 

Vertex:14, 

-0,9, 1,5. 

-0.9 

Vertex:1b. 

-0.6, L5. 

-0,9 

Vertex:16, 

-1. 0. 

1 

Vertex:17. 

■0.6. 1.5, 

0.9 

Vertex:18. 

-0.9. 1.5. 

0.9 

Vertex:19. 

0.9, 1.5. 

0.6 

Faces: 9 

Face: 0, 0, 

. 1. 2. 3 


Face: i, 4, 

. 5. 6 


Face: 2, 4, 

. 6, 7 


Face: 3. 8, 

. 9. 10 


Face: 4> 3, 

p 10. II 



Face: 5. \7.. 13. \k 

Face: 6. 12. Ik, lb 

Facet f, 16. 17. IB 

Face: 8, 16. 10. 19 

DiffuseColoril.0 1.0 0.€ 

AppleScrifi 

The next tiling we do is to write an AppleScript to convert 
the raw 3D text file Lo 3nMR In the folder <your 
harddisk>:Apple l:xtra.s:AppleScript you find the application 
ScriptMaker whic'h you can use for writing AppleScrifiLs. First we 
disaiss the structure of our script, then we fiU in the details. 
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The sitructure 

Listing 3 shows the structure of our conversion script 
Convert to 3DMF. We use the on open construct so that we can 
use tfie script as a droplet. The file specifications of the files 
dropped onto llie droplet appear in the list inDocLisl. We 
traverse the list inDoeiisl dmiugh a repeat command and act 
on each hie in turn. First we do the fno.si basic of error 
checking. Witliin a try statement we check whether the file is 
of type HTXT'. If it is not, we bail out by throwing an error 
which lends to execution of the on error portion of the try 
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statement. If it is a text file we call ihe parse handler. Within 
the parse handler wc again have a try statement in which we 
Iry to extract the relevant information from the raw 3D text 
file and format it according lo 3DMF standards. If all goes 
w'ell we call the wrileResultFile handler with as arguments the 
file specification of the raw 3D text file and the lexL of the 
3DMF file to write. Within the writeResullFtle handler we try 
to create a text file within the same directory as the raw 3D 
text file and ifie same name, except for the extension which 
wc make 3df. Now that we have some idea tif llic structure of 
our scriptp let’s turn our atiention to the parse handler. 

Listing 3: The structure of Convert to 3DMF _ 

on open [inDonLiut) 

- iraverst' fht^ iisc of Hies that were drtjpped on ilie dropki 
repeat witli dieFilcPath in inDocList 

try 

tell applicatioTi '’Finder^ 

-minima! errcir chucking: 

-cheek wlietliur the Ok U of type texi. 

-if it Isn't Jhmw sin cm>r 

if (get file type of file theFilePath)^^*TEXT" then 
error "ThiiS ia not a text file." 
end if 

end tell 

-if wc gei here the file npe is TEXI" 

“and wc parst' rhe rde, 
parse(theFilePalh) 

on error itiErrorText 

”h;indk any tTrt^rs tbal nny tjceun 

displiiy dialog ("An error has occutred:" 

& inErrorText) 

end try 
end repeat 
end open 


on purse (i riF i 1 oPath) 
try 

'Here wc try lu rc;id die raw U) (lie, 

-extract llic alcv'Mil infoniialion, 

-and format it inio 5nMF fomi:ii. 

Ccode omitted) 

“(I'lJi a kmdkr to write the result to a fik. 

writeRofinltFlle(inFilePath. theOutputStririg) 

on error luEnorText 

display dialog ("An error has occurred:" ^ ^ 
inErtorText) 

end try 
end parse 


on writeResultFlle (iriFllcPath t ! nOutputStrlng) 
try 

-Here wc try to citrate a new text lik 
-in the same directory as the raw :^D file, 

-only with the extension '3dP instead of 'ixf. 

-and wrife imr formatted result to it. 

<!c:ode omitted) 


on error inBrrocText 

display dialog ("An error has occurred:" ^ inErrorText) 
end writeResultl'ile 


The Parse handler 

For the t:odc of tlic parse handler please refer to Listing 4. 
Firsi wc read all of tlie mw 3D text file into a list called 
theLineList using rerurn,s as dt^lirnilcrs. This means that each 
element of the list theLineList contains one line of the raw 3D 
lext file. We llien traverse this list of lines using a repeat 
statement and look at the stan of eatrh line. There are numl>er 
of possibilities. 

If a line Siam with “description^ we are dealing with the 
first line of the raw 3D text file which holds a description. 
Although this may seem .superfluous as the file has a descriptive 
name, it can ix^ a convenient location to store a long (>32 
characters) description of the 3r> object in ihe file. We ignore the 
worI Me.scTipiion’' and the colon and store the rest of the line in 
the string variable theDescription. 

If a line starts with “veitices” we have come across the line 
which signals the start of the veiiice.s description and which tells 
us the number nf venices in the file. We simply ignore this line. 
Instead of gralibing tlie number of vertices from this line we will 
count the vertices as we encounter them. 

if u line starts with '’faces" we are dealing with the line 
which signals the slart of I lie faces description and which tells us 
the numi>er of faces in the file. Again we ignore this line as we 
will alstj count the faces a,s we encounter them, 

if a line starts with "vertex” we have a line wnth a vertex 
description. We ignore everything on this line up to and 
including the first comma w'liicit means that we eliininate the 
word "vertex’’ and the number of the vertex. 1 he remainder 
of a vertex description line needs .some filtering. We traverse 
this remainder looking at each cliaracicr in turn. We replace 
the commas by spaces and eliininate supernuous .spaces. For 
tills last action we need to keep track of the last character 
using the variable theLastChar. For exain|)le, if there is a 
space between a minus sign and a comma we eliminate that 
space. Als<i. if there are multiple consecutive spaces we 
reduce them to a single space, Tlie characters we wish to 
keep are appended to the variable theVerticesString. After 
each line we add a comment with the index number of the 
vertex, by the time we have finished parsing all the vertices 
theVerticesString holds nice, clean versions of all the vertices 
in tile file. 

If a line starts with “face" wt* are dealing witli a face 
de.scription. I'he filtering of a fa< e descri[>lion is pretty similar to 
that of a vertex description. Again we ignore everything on this 
line up to and including the first comma. Thi.s means that we 
have got rid of the word "face” and the number of vertices 
involved in the face. Unlike with a veitex line, we need not 
woiTy about decimal places. What we do need to do is count the 
nunTl:ier of veitices involved in a face. If a digit is yyreceded by a 
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.space or a comma we incTcmem the variable 
IheNumberOfVerticesInFace. llie characters we wisli to keep are 
appended to iJie variable theFacesString. After each line we add 
a comment with the index nLinilxrr of the Face. By the time we 
have finished parsing tlie faces theFacesString liolds a nicely 
lonnatted version of all the faces in the file. 

If a line starts wdlh "DiffuscColor" we are dealing with 
the colour specification. We ignore the word '^DiffuseCtdor'’ 
and the colon and store the rest of the line in the string 
variable theColor. 

If a line does not conform to any of the previous options, 
then we cither have an empty line or a line that we <Su not 
currently supi>ort. Tlie.w lines are simply ignored. 

In its current form, the script does not c'iiter for hole.s. The 
number of contours is simply set to 0. 

Tile rest of tlie parse handler a.ssembles the various parts 
into a string variable theOutputStr. All we need to dt> now is W'riie 
our freshly forniatreci string theOutputStr to a file through the 
handler wrileResultFile. 


Listing 4: Parsing and formatting 

on parso( IriFilePath) 

-inituilisc the riuiniKrr tif vertices 
set theNufflOfVerts to 0 

-iniiiaiiiic Uic number of fiicc.'i 
set theHnmOfFneo.*!! to 0 

-rtie string wilh vertex ifL-scripiiojis 
SOL iheVertffStr to 

-the string Willi face Utscripiions 
set theFaeesStr to 


parse 


try 

the conrenr of the text lilc into a list. 

-I )!i£r rimim as the ddlmilcr. 

-'Ihis maktx each lisi cScnifin one Mne. 

copy (read iiiFiiePath as list Using delimiter ret urn)”’ 
to theLineList 

” Tmmsc the tisi of lines, 
repeat with i Frotj 

1 to the number of Items in theLineList 

SOI LheLine to item i of theLineList 

if theLine contains "Description" then 
-Skip tlTc label Mtaserription" and copy the rest, 
set theDescr ipt ion to characters 

((the or [set of in theLine) +1) ■» 

thru (the end of theLine) of theLine as string 

else if theLine contains "Vertices" then 
-Signals ibc Start ijf the vertices list: do n<Khing 

else if theLine contains "Faces" Lheri 
-Signals the start of the fiiccs list: do notliii^. 

eL^e If LheLine contains "Vertex" then 
-Ibis is a vertex description 


-■['rack lilt List character wt itutl. 
set theLastChar to "" 

-Tniverst fhe lin t from the comma to die end of the line 
repeat wd Lh j from t (the offset of "," in 

theLine) +1) to the number of eharacters-i 
in theLine 
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copy character j of theLine Lo theChar 

if "1234567B90-** contains tbeChar then 
“These are valid duiraaeni wMi we keep 
set theVertsStr to theVertsStr i theChar 
else If theChar “ then 
-Wc replace* ccimmas by spaces 
set theVertBStr to theVertsStr A " " 
else if theChar = " then 

if theLastChar = ”'' then 

-line starts with a space r don't copy \hc space 
else If theLastChar ^ then 

-space preceded by a minus sign: don't copy the space 
else if thel^stCbar = « « then 
“iVo consecutive spaces: don't copy the *" 
else if theLsstGhar = " ^then 

-space preceded by a comma: don't copy the space 
filss 

-This is a space we wisli lo keep, 
set thp-VertsStr to theVerteStr h ^ 
end If 

end if 

- Keep track of die last chanaer 
copy theChar to theLastChar 
end repeat 

-We append a comment with ihc venex numIXT to tJiis line, 
set theVertsStr to ihcVensStr & 

" ^ theliiiiiiOfVecLs & return 

“(ncremeni the niimlXTof vertices we liave dealt with, 
set tbnHuiOfVerts to theNmijOfVerts + l 


else if theLine contains "Face" then 
-llils is a face description. 

set theCurrFaceStr to "" 

sot theLnntChar to 

set IhaNuinOfVertnlnFaee to 0 

-Skip everything upto imd inciiiding the first comma. 

“Iraverse die lim' Inmi the comm^i rn the end of the line 
repeat with j from ((the of feel of in “> 
theLine) + 1) to 

the number of characterB in theLine 

copy eharacier j of theLine to theChar 

if ■'1234^6/890” contains theChar then 
- lliese arc valid eliaraciiTs which we keep 
copy theCurrFaceStr 6 theChar to ^ 
theCutrFaceStr 

-tf this valid charaaer & preceded by a comma t)f a space. 

^hen it must he a new vertex number, 
if theLastChar = or theLastChar - " " then 
copy UieNuroOrVertsTnFace + 1 to ’’ 
theNumOfVertalnFace 
end If 

else if theChar “ then 

-We replace commas by spaces 
set t licCiirrFaceStr to theCurrFaceStr & " ■' 

else If the Chat - ** " then 

if theLastChar “ then 

-Line starts widt a space: don’t copy ihc space 
else if theLastChar ^ * then 

““ * preceeded l>y a minus jagn: don't ctjpy Uie space 
else if theLastChar ^ ’f ^ then 
“TVvo cortscculivc space s: don't copy the " * 
else If theLastChar = *,* then 

-space pftceded by a amimardoni copy the space 
else 

-This is a space wc wbh to keep, 
set tht'CurrFsceStr to theCurrFaceStr 6 ” * 
end If 


end if 

-K£q> track of the bst character 
set theLastChar to theChar 

end repeat 

-Build a line with a face desenption. 

set theGurrFaeeStr to thofiumOfVertelnFacc 4 ^ 

" " 4 theCurrFaces Lr 4 " ^ 4 4 theKimOfFaces 

-Build die descriplkm uf all the l^x'es. 
set theFacesStr to theFaoesStr 6 
theCurrFaeeStr 4 return 

-Incrcmcnr the number of foces. 

set theNum Of Faces to thaNtirnOfFaces f 1 

else if (Item i of theLlnsLlsL) 
contains "DiffuseCoior" then 

set theColor to characters ^ 

((the offset of In theLine) + 1) ”> 

thru (the end of theLine) of theLine as string 

else 

“Pri>hably’ an empty line (jt Mimcibing unsupported, 
end If 
end repeat 

- nietc arc no tiolcs in our model m> the number of contouni Ls 0* 
set theNumOfContours to 0 

-'fhe 3DMF header. 

set theUeader to "lDHotafile(J 6 Normal toc>)" 4 return 
-llic desoriplion 

set theDescriptioti lo "#*' 6 ihcnescrJ ption 4 return 
“I'he altrihiile set 

sot iheAttrlhuteSet to "AttribyteSet ( )" 4 return 4 "■ 
”IH f fuscColor (" 4 theColor & ^)" 4 ^ ffr g b" fr* 
return 

-We'vtf got the parts, now asMinblc the 5DWF ftk' 

Hn the string i*arial>le ihcOulpulSlr, 
set theOutputStr to 
thcHcador 4 
thoBcscr iption 4 "* 

^Conlaluer (" 4 return 4 '^Mesht" & return 4 “> 
theNumOfVerts 4 ” tmm of vertices" & return 4 
theVertsStr 4 

theNumOfFaces 4 ” liuim of faces" 4 return 4 “* 
theKumOfContours 4 " Inum of contours" 4 return 4 ^ 
rheFacesStr 4 “* 

4 return 4 

"Container £" 4 return 4 ^ 
theAttributeSnt 4 
"}" 4 return 4 "> 

11 J, n 

“Call a handler to write the result to a fUc. 
writeResultFile(inFilePath, theOutputStr) 

-DoiuH 

beep 

on error inErrorTexi 

display dialog ("An error has occurred: " 4 “> 
inErrorText) 

end try 
end parse 


Hie writeResultFUe Handler 

Now that we have the string theOutputStr all Uiat remains 
to do is to write it to a text file. This liappens in the handler 
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wfiteResultFile {Listing 5). fn \hv inFIfePath par;iitn;?ter we 
pass the handler the file path of the raw }D text file. We warn 
to ereaie a finished 31>M1' in the same direetory and with the 
same name as the raw 30 text file hut with a different file 
extension, which we want to be 3dh If the raw text file has 
the file extension txt we chop it off first. Using the newly 
created file path theOutlilePathStr we open a hie with write 
permission. We then WTile our string inOutputStr to this file 
and set its type and creator. The type is 3nMF and here we 
use SimpleTexc as the creator though of course you can 
change the creator to the application of your choice. Finally, 
we close tlie file. 


Listing 5: Writing our result to a iiie 

on writeResultFiledriPileralh* inOutputStr) 


writcKesultFik' 


-< jLst the flic piiuJi Lo 3 string. 

copy inFilePath as string to theFilePathStr 

write itie resuUmi; 50MF file m ibc i^nit; dinxnon’ as iHU original ti!Xi file. 
- if iht fik path emls with .m ait off Uh: ixt 
if (theFileFathStr) ortds with *,txt" then 
set theOutfllePalbSt r To [characters 1 thru 

((the offset of ".Ixt" in theFllePathStr) - 1) ^ 
of theFiiePathStr) as string 

else 

sot theOtitf ilePathStr to theFiiePathStr 
end If 


-Apix^ml .3df to the file path in cast of use by 'the evil empire', 
set theOutfileFathSir to theCiitfileParhStr & ".3di'" 


to 3DMF anti ch<H>sc classic a]>plet from the structure popup 
menu. Now drop the raw 3r> text file rable.txt on the Convert 
to 3DMF droplet. After a brief pause the ^fac Ix^eps and a file 
called table.3df aptxrars in the same directory as table.Ixl. 
Double click die file. Siinplelext should open and tlic 
QuickDraw 3D Viewer sluuild display our talde as shown in 
Figure 2. ff you arc unsure how to use the controls of die 
QuickDraw' 3D Viewer, check out Balloon Help as ii is quite 
helpfuL On some systems the file may not open correctly after 
a double click in the Finder and shows as a QuickTime movie 
instead. This can be solved by launching SimpleTcxi and 
choosing table.3df from the File Open dialog l>ox* As this is of 
course aw'kward if you would like to open multiple files, 
Listing 6 shows a small script for a droplet which ctJirecily 
opens 3DMF files that are dropped onio it . Note that if you 
use a non-Knglish language systeni, AppleScript may ask you 
to locate your localized copy of SimpleText which is hiding on 
your harddisk under a different name* 

listing 6: Open3DMF 

0ti Ope n (InDocL I st) 

repeat with theFileSpec In InDocIiilfft 

tell application "SiropleText" 
open theFileSpec 
activate 
end tell 


-t^rciitc A file to write our R'iiuU to. end repeat 

copy (apan for access file tbeOytflleFathStr "* 

with write pormieaioti) to theOatFileRef end open 


-Wriit the mitpm siring to the file. 

write inOutputStr to theOuiFileRef 

-Set r)'pc nnd camior. 

tell application "Finder" 

-Set the t^*pc to 3I1MH ilic file type of a Moilik. 

set Tile type of file theOutfilePathStr to "3DMF" 

-Wf want tiu’ file to be ufX'nihle by SimpleText (creator “ttxt“>. 

“llut of course otJvers aa- |Kissihle; 

-FtjrtnZ (ercaior ’T1V*S’'1 
-C*eo30 (ovaior 

-AOMFOptJmiiter (ea-^uor X>P2(f) 

set crentQt type of file theOutfiiePathStr tg "LtKt" 
eud Loll 

-tHose the asuli file 

close access theOutFlleKef 

on error InErrorText 
-CloH' ihe a'fiiili tile 
close occcsiS theOutFileRef 
display dialog ("An error has occurred r 
Si InErrorText) 

end try 

end wr itoRenuitFile 


Finbhing and trying out our script 

We finish our scripi by uiming it into a droplet. Choose 
.save a,s from ScripiMaker's file menu, enter the name Convert 


DistiissroN 

In this article we showed you how' yt>u can get your data 
into QuickOniw 3D’s 3D Mciaftle format. We barely scntichcd 
the surface l>ut now' that you arc up and walking you on teadi 
yourself how' to run using the following pointers. 

Quesa; QuickDraw 3D to the fiiture? 

Quesa (w'ww'.quesaxjrg) is the asuninding open st>urce 
effon to buikl a 3D grafiliic.s lilinuy which offers binary and 
source level compatibility w'ilh QuickDraw^ 3D; If you are 
hcsiiant to support QuickDraw 3D because of Apple's 
announcement to drop the icchncjlogy, you may wish to 
investigate Quesa. Quesa is not only suitable for Mac OS8/9 and 
MacOSX, it is completely crossqilLUforni wilh sui>p<3ii for 
Windows and Linux. A poil for lie is ex|>ected. 

Learntng more about 3DMF 

You can find a well organised coltceiiori of links to 
QuickDraw 30 dcKumenialUm, including the 31-> Metafile 1*5 
Reference documentation, at wvwi/.qjey.OTg/other/links.hlrpl. A gtxxl 
read on a rainy Sunday afternoon, the 3D Metafile 
diKumentation tells you in approximately 230 pages everydiing 
there is to know' alnnit 3DMF. You .should pay special aitention 
lo these two aspects of the 3D Metafile: 
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* Alternytivc geometry rypes 

For our file we have used QuickDraw 3D’s inesli geonlet^>^ 
Tlje ad vantage of the mesh is that it ts easy to understand 
and write and that tliere are many QuickDraw 3D calls for 
mesh editing. Its hig distidvantage Ls dial it is rather 
iiiclUciem when ti ct>nie.s to rendering, ff you arc mainly 
interested in fast rendering you may wisli lo ltK>k into two 
other geometry types: die polyhedron and tlic irimesh. 
Another option is to use 3DMF Optimizer liy Pangea 
Software to convetl your meshes into trimeshes 
(WWW. [la 11 gea soli .net /d t j \vn 1 r >a ds. lit nil). 

• Binaiy vs, ASCII 

So far we fiave been writing 3DMF ASCII files. Tlicre is 
also a binary 3DMF format. The binar)^ format results in 
smaller files which can be read faster by QuickDraw^ 3D 
applications. Luckily, there are conversion utilities around 
which convert our 3DMF ASCII file to a 3DMF binary file. 
One such utility is Anatas by Stefan Huber 
(www.iopoi.th). k converts from ASCII 3DMF to liinary^ 
3DiVlF and vkc versa. 

Better tools for AppleScript 

Wliile ScriptMaker is a great freeliie and quite adequate 
for writing small AppleScripts, you will start to notice its 
limitations as your scripts start to grow'. There is no buili in 
.search and replace, variable watching or step-by-step 
debugging. If you feel you need a better AppleScript 
develo[)ment environment have a look around at Developer 
Depot (www.developerdppDr,com), There you will find some 
professional AppleScript Itiols, 

Better 5D ltH>ls 

As the name implies the (QuickDraw 3D Viewer is limited to 
view'ing 3DMFs, It does not allow you to edit them. A far more 
capable freeware application is Gco3D by Stefan 1 iulx^r wliidi 
is a Ix^itei viewer and adds some editing and animation features 
(wwwMoptii.ch). If you need a full-blown modelling, rendering 
and animation freew^are package you may wish to consider 
Sfrata3D (vyww,strala.com/html/demos_updates.htm^ This is a stripped 
down version of what used lo lie Stntta StudiolTo. Finally, most 
comiiicRaal 3D applications edit 3DMFs. 

CONCTIISION 

This article showed you how to use AppleScript lo take a 
mw' 3D text file and convert it into the 3DML‘ file format, 
viewable by any QuickDraw 3D applic-ation. Fart of the ftin was 
that the technologies and applications that we used— 
QuickDraw' 3D, the QuickDraw 3D Viewer, AppleScript and 
ScriptMaker—all cotne standard with your PowerMacintash, You 
can of course push the l^jundartes further by trying to export 3D 
data from your hivourite commerdal database or spreadsheet 
application. Enjoy! 
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ADMIMISTRIVIA 


By John C. Welch 

Fun with AppleScript 


A fairly useless detour that nonetheless 
shows you some tricks with iTunes and 
Entourage v.X 

Weix:()me 

Okay, so my lasT couple of aiticles have bc^n technical, (no 
SLir]:>rise, this is Mac*1’ECH*, after all), bul nonetheless, they were 
pretty dry to not only re^tcl, hut write as well, (llte USB2 sfx.‘c is 
a cure for insomnia) So this time, 1 tliou^jht I‘d lake a l>it 
of a turn, and share a fun hit of AppleScript that I had done with 
iTunes and Microsoft Entountge for Mac OS X. 

Gfj Sig From iThnrs 

St^meone had shown me a neat apiiHcxilion that was designt^tl 
to get the name of the aimmt track fix)ni iTunes, and insert the 
track infonnation into your Entourage email mes.sage^ H was well 
put together, but there wcm some things that 1 didn't like alx>ur it. 
i-irsi, it was a background application jxilling two other 
applic-aiions. That seen>ed a hit kludgy to me, as this stdf)i didn't 
really need to nm that way. To my way of thinking, it is more of 
an Kntotirage nscript, so it should mn inside of Entoumge* Since 
Rntourage is exiremely scrip! able, and has support lor sciiedules 
that let you schedule, among other things, AppleScripLs. it seemed 
to me that there was a way to have this mn in Entourage's 
application .space. A few hours of work, and voila', if was done. 

If you want ro just download the script, it's available from: 

<http://web.mit.edu/jwelch/wwvv/files/Mac OS X 
Scripts/EntourageX/SigFrom[Tunes.hqx> 

IIjc itiost recent versions are there, and it is fairly w^^ll 
commented, so if you don't want to type this all in manually, you 
can just download it I'roiii theie. 

Main functions of the script 

As I Sitw it, the script liad to do a few things, which made 
writing it pretty easy. It had to Ix' able to get tlie current track 


information from niines, whicli 1 defined as the Trac k Name, the 
Track Artist, and the Tracdt Album, If i'funes wasn't playing, tlien ii 
had to siitKstimie a signaaire from the user's list of random signatures. 
If there wcrc'n’t any random .signatures to use, then it had ic> insert a 
default sigi^atiire, 1 ended up finding some interesting cliallenges in 
tliis, including one bug tliiit axild only hat)tK;n in such a specific 
a)nfigumtion, lliai it got its own name, Tlte La Gma Rug". 

'flic script then had to lake tliis riimes information, and 
create a signature out of it, and insert this text into a predefined 
signature in Entourage. I ended up attaching the script to a 
sclietlule that runs every minute, so tlie track info is current. As 
of this article, it's been running constantly w'hcnever 1 run 
Entourage, {which is ]>rerty much 24x7), and no real proldems. 

lake most tilings witli Apple.Scrifit, you end Lip gening help from 
the jxx>ple in the community, Ixxh with the tTxIing and with the 
testing. Eor the txxiing, I want to thank the Iblks on the Entourage 
mailing liKi,<mailto:EntourageTalkKin@listsletternpxom> specific-ally Paul 
Berkowitz, and IXm Cnevier, (who ako wcmIcs for the MacRU and is 
a major reason tor the AfipleScript c|iuility in things like Outkx)k 
Fjcpress and Entourage.), fVir testing, lx.‘sides the aforementioned 
(Jeff) hi Gaia. I'd like to thank the memix^j^i of the Your Mac life 
mailing list, <httpi/I fSlimymacgroups.com/mai Iman/listin^ who were 

quite helphil during the testing of tills scrifU, 

Some caveats: 

1) This has Ix^en tested by me anti most others in Entourage 
v.X anil i'funes 2/3 in Mac OS X oufy. \ have had reports of it 
w^orking corrc-ctly in Mac OS 9 with the native versions of the 
programs there. If it does, cfxil, hut fm not going to worry if it 
doesn't. If you wisli to change things lo fix that, excellent. 

2) It only works with Entourage. 1 thought alxiur Hudora, Ixit 
the A]i(?ieScri[>t diaionary for ihai Applicaiion makes my fic^ad him. 
If you want to get it to work with Eudom. plc^isc let me know when 
you do, 1 |iersonally know a few peofile who wall love you for it. It 
can’t wi>rk with Mail at the moment, anti Netstiipe's dictionary isn't 
even dose to allowing it. 1 don't use Fow'erMail, or MailSmitli, so 1 
don't know' if you could mtxlify it for that, But anyone who wishes 
to may cerUilnly use my ccxle as a sUirting point. 

3) fm not an AppleScript genius. I’m a pickup tnick 
programmer. Most of my solutions are simple enough that 1 can 


John Welch <jwe1ch@mtt.edu> us a CoaHiiltant with MU IS, and the Chief Know-It All for TackySInn. He lias over fifteen years of experience at making 
computers work. John specializes in figuring out ways in which to rreike ihe Mac dtj what nolxidy ihinks it can, showing that the Mac is the .superior 
administrative pbttbnti, and teaching others how lo use it in interesting, if sometimes frightening ways. I le al.sr> does tilings iliai don’t involve 
compulerlry on occasion, or at teasl that’s the rumor. 
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reiid them in six months and remember why I did it that way. It' 
yon care to of)iimize my codes dt?, and then comment ii 

so I can ^laylx^ pick up a pointer or two. 

So enough of iliis, iefs dig into the code! 


The AppleScript Code 

Tile first section of this sets up some basic varialiles, and 
checks to see if iTunes is running at all If it is, dien we set a flag 
to siiow this. Otlierwise, we avoid trying to get the track 
information, and dump into ilte iTunes isn’t playing’ scxtions. 

set ieiTunesRmnlng to 0 

!iet theN&wSig to 

set iTunesIsPiaying to 0 


The first three lines are pretty simple. ’J'wo flags, 
isiXunesRunning' and iTuncsIsFlaying' are set to 0, wiiidi is tJie 
s;ifer value. iheNewSig*, the variable used lu hold the signature 
that will Ik‘ liuill is initialized here as well 

try 

^lit- iry ;*lkjws fat pniJikiiis isatJtig Uk- Jem fnm thtt fimlef imtlmii lirctlJiiK tu 

-p(>]> In If ihis tijiHfs ouL 

tell application "Finder" 

if (get name of evf>ry process! contains "iTuneo" then 

-itTFuncs istit runniiigulitii iissumc the w^ints ihini 4 s ihis way;uid leave ihings 

-akine like i gotHl boy 

set isiTunesRunnlnfi to 1 
end if 
end cell 
on error 
quit 
ond try 

I'his section asks the Finder if I'l'iines is running* If it isn’t, 
then JsiTunesRunning stays at D, if it is, then it gets set to 1. The 
try hkx:k was needed Ixitausc if Entourage was parlit ularly 
busy, or the Finder was, or i)oth were busy, then you’d get an 
error alert complaining that the script couldn’t get tlie name of 
every' prtx'css. If any emirs cxcur, the script quits, and you just 
watt until the next run to uixiate things. 

if iBiTunosRtmnin^ = 1 then 


tell application "iTunes" 
^itart t;Ukifig in iTimcJi 


if player state is playing Lh^n 
-now wc want tu set- if Uunn^ is even playin;? 
set iTuneiiTsFlayiiiii to 1 

set thcNavic to the name of the current track 
-gel I he track name 

set theAririst to the artist of the current track 
-iicl live aftisL name 

set theAlbum to the albuni of rhe current track 
-get the album name 

if theAlbtini is then set theAlUum to "Beats the hell 
out of tre" 

-dcfaull if no album name 

if theArtist is then set theArtlst to "Wlio the hall 

knows" 

-defaiili if no ariisi name 

if thoNaiiR is *" then set theKncio to "Too Zen for rae" 
-default If nf> track name 
set ilieNewSig to 

I'ra listening to " h theNsme & " by ” S theArtist 4 " off of 
" k theAiburo 

-now wr set ibc sig lo the ITlmcs values. This Im to 

-happen herc.oihefwbc wc ovarkk other tkhiulLs. iliai would be had 


end if 
end tell 

-<jur nhnes wi>rk Is done 

if iTunesTsPlaying *• 1 then 
-mints IS running AMU pbying 
imiidSigItbcNcwSig) 

-iuiild the signature from the niutes data* and upebtt the e'rage sig since we 
call 

-the same code twice. lei‘s make it a handler, and save space 
elan 

-mififis is ruiming.buL not pbying 

set thoHewSig to bulldSigWithout!Tunes(theNewSlgJ 
H.-ail the handler that builds a sig without iTunes nmninK 
bui1dSig(lheKewSig) 

-opdatc the sent sig to some random sig created by the pffvious line 
end if 

else 

-iTunes isn't mtining or playing 

set theNowSLg to buildSlgWithoutITunes(theNawSig) 

-call the handler that bitilds a sig wiiinnu mines running 

bulld Sig(theNewS i g) 

-update tile sent sig to some random sig created by the previous line 
end i f 

1lie first line tif this seaion tests to see if iTunes is running. If 
the flag, 1.siTuncsRunning’ is sci lo I, then iTunes is running, and 
we .start talking to iTunes. Oilierwise, this section is skipped. Tbe 
Tell hitxrk' routes all liie commands inside the Tell lilock' to nVmes, 
and tlie finsi tiling w need to know^ is the player state. rrune.s could 
lx on, liut not pkiying. So Lite if j>taycT stated is playing’ line asks 
n'unes for this infoniiatioii. Tliere aa' five pcxs.sii>le values for 
■player stale': slopped, playing, paused, rewinding, fast forwarding. 
-Since wc only care alxiut playing, we use that as niir test. If die 
■[)kiyer slate’ is playing, liien TTunesIsPlaying' Is .set to I. 

Since iTunes is t>laying, we now get the names of the track, 
ilie ani.st, and the album the track comes from and put them into 
ihcName, tlieAnisi, and iheAlbuiu, respectively. We llien test to 
see if any of these' varial>les are blank, inditaling that iTunes 
doesn’t (rave tliis information, and if they are, we insert default 
values into them. Once this is done, we create the new signature 
text, and put ii into TlicNewSig’. T he reason why it looks a little 
fxld is that I inserted returns so tliai we sou Id get a gtMid 
.siruuure in the email message. Hie ccxle for these is ’\r\ but 
when you compile the script, AppleScript converts these to 
actual returns, so you gel the breaks instead t)f the characters. 
The pre-eompiled cmie for the signaiure text is: 

\rrm listening to tlieNanie ik “ by “ ^ iheAitist Ik “ olT 
tif" ik theAlbiim 

The characters alhnv me to concatenate the data in 
the three track variables into llie text string of the signamre. 
Once that is done, wc close the if statement widi an "end if, 
and the icll block with an ’end tell’, and tliat’s all we need to 
talk It) iTunes for. 

Tile next if statement checks the value of ‘iTimeslsPlayingT 
If it is T then we call die handler 'buildSigO' and pass it the 
variable thcNewSig that we just created. Tliis handier is pretty 
short, as seen i>elow! 

on buildSi^CtheSi gnature) 

-handkr/subrouiinc m Jict the sjg in E'Ragc 
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REALbasic® 


REAL Software and MacTech present the REALbasic Showcase to 
liigliliglit some of the fantastic solutions created by REALbasic users 
worldwide.Tlie showcase illustrates the wide range of applications that 
developers using REALbasic am create. Some benefit any Mac user,jmd 
others are more specific.AU of tliem are seriously cool! 

REALbasic is the powerful, easy-to-use tool for creating your own 
software for Macintosh, Mac OS X, and Windows. It runs natively on 
Mac OS X as well as earlier versions of the Mac OS. For more 
information, please visit: <www.realbasic.com>. 

The Made with REALbasic program is a cooperative effort between 
REALbasic users and REAL Software, Inc. to promote the products 
created using REALbasic and the people who create them. For more 
information about the Made with REALbasic program, please visit: 
<www.realbasic.com/realbasic/mwrb/Partners/MwRbProgram.html>. 








REALBASfC SHOWCASE 



Whistle Blower 

Enterprise server monitor and restart utility 
whistleblower.sentman.com 

Connect to and validate the response from web servers, 
cgi scripts and over 23 other types of servers. 

Send email, pages and perform unattended restarts via 
/viasterSwitch or PowerKey. 

Shifts make sure that the person on call when rfie server 
goes down is the one who gets the page. 

68k, PPC and Carbon 

Web based administration lets you check on and res/or/ 
your servers from anywhere. 

Customize your response to an outage wi^ App/e Script, 

email us at whisrieblower@sentman.com 



^MAC MUSIC MANAGEMENT FOR"^ 
SONY« 5 TO 400 DISC CD CHANGERS ^ 



Control up to 12 changers (4,800 music CDs) 
Control Any Brand Stereo Receiver 
Play MP3 and other Sound Files 


Plus much, much more!!! 
vwvvv^titletrack.com info@titletrack.com 



piPop 

Pop-up Hierarchical 
File Navigation and Launcher 



T elnetLauncher 

Bookmark and Launch your 
Telnet and SSH sessions 




SimpleKeys 


Set your Function Keys 
to type stuff for you! 


piDog Software 

http://vvww.pidog.com/ 


Tlf jM/ifot ^ 



Got a great product built 
with REALbasic? 

Promote your product through the 
very cost effective REALbasic 
Showcase in MacTech Magazine. 

For more information, contact us at 

adsales@mactech.com 
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DOWNLOAD NOW 

www.ebutterfly.com 


Enjoy your personal collection of photos, digital music, 
video clips and more with one integrated media browser 


• Reads 20 Popular File Formats 

• iPod Audio Playback 

• Audio CD Playback 

■ Slidestiow with Adjustable Timer 

• Add Favorites to Custom Playlists 

• Zoom & Scale-to-Fft Options 

• Image Rotator 

• Audio Bass S Treble Controls 

• Audio Equalizer Display 

• Search Engine & Media Filter 

• Displays File Properties 

• Improved Rle Browser 

• Redesigned Interface 


Corona 

accounting software 



"Easy to set up, easy to use, 

and excellent support from 
the developer" 

Five stars on VersionTmckercom 
Four cows on 7\L€Owsxom 


• cash entiy 
• invoicing 

• payroll 

• reports 


$64.95 


Version 1,9 now with: sates tax accounting 
"keyless entry" invotos 
drag 'n drop accounts 


Free 30-day trial 

http://lioniepagejnac.coin/idlevkild/CorDnaUS.hqx 



A best friend for business! 

p.o. boK 472 ■ aurora ■ Oregon • 97002 
icflowild#mac.oom 


Extend REALbasic with 
Advanced Plugins 


Spreadsheet Controls: 

We provide a wide range of spreadsheet controls for 
REALbasic, including multistyled and custom rendering 
spreadsheet controls. 



• More than 32k of rows. 

• Classic, OS X and Win32. 

• Accelerated for maximum 
speed. 

• Images in cells. 



OflOOlO 


Cryptography: 

We provide data encryption, encoding, 
compression and hashing for REALbasic. 

Supported Algorithms: 

• Encryption: 

- e-CryptIt 

- BlowFish (448 bit) 
-AES(Rijndael)(256bit) 

• Encoding: 

- e-CryptIt Flexible 

- Base 64 

- BinHex 

- MacBinary III 

- AppleStngle / Double 

- ULICoding 

• Compression: 

- Zip on Strings and streams (.gz) 

• Hashing and Checksums; 

- CRC32 / Adler32 

- MOS/HMAC_MD5 

- SHA / SHA1 / HMAC_SHA1 


Other Plugins: 

We have many other 
plugins for REALbasic. 
inclyding plugins to do 
advanced MacOS 
Toolbox tasks and more 
custom Controls. 



Baenannae^l 


Speed up developement and make 
more advanced applications 
by using plugins ! Get free demos 
at www.einhugur.com 

Einhugur Software 
sales@ein hug ur.com 
www.einhugur.com 
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tell sppliealion "Hicronoft ERtoura^e" 

-IhL^ at.tuall)' ends up siting the signature ^after* you send tlic mail, 

-l)ui uniil I get a pniptT sigitanire property, it's the onI>^ ritii>^kJudg>' way lo do litis 
if exists signs cure "iTmtesSlg*' then 
-if fThnes Sig b dteie 

set the content of signature "iTunesSig* to 
theSlgnature 

-change ihc ttintents 
else 

-if it isn't tticrc^ 

aiake new signature with properties tname: "iTunesSig". 
contentttheSlgnature, Include in random;false) 

-cToic O'unes Sig, wilh the corivct contents 
end If 
end teU 

end bulldSig 

This liandlur tells Entourage to set a specific signature to the 
contents of 1heSignature\ which is carrying the data from 
theNewSig. One c|Liii*k here is tliat you ^ire aaually changing the 
signature after the message is sent, as yon tran'l directly 
manipulate the signature in an email message yet. Tlie ftnit 'if 
inside the tell hlcx'k asks Entourage if a signature named 'HTunes 
Sig” exists. If it dot\s, then the content of that signature Ls changed 
to the content of lheSignature\ and we're done with the liandler. 
If “ri'unes Sig" doesn t exist, itien we usc^ llte 'make new 
signantre' statenient to cTeate the signature, name it “il'unes Sig'\ 
.sel live content to Ihe.Signature^ and make ti a non-random 
signature, (that last hit is iiiiporlani. If "iTunesSig'' is random, you 
can Stan ,setting up for the Li Grua bug.) Once thaEs done, we re 
done with the liandler, and we jump back into the main [irogratn. 

Now, at the beginning of the signature Iniilding block of 
code, we checked to see if i'lunes was playing. If it wasn't , (if 
we go! to iiere, ilien iTunes is lunning, but is not playing), then 
we have to ea^ate a different signature, so we set theNewSig' to 
the re.sults of a tlifferent handler, liuildSigWithoutnune.sO', anti 
pa.ss it iheNewSig’. Tliis lumdleTs ctKie is shown Ix^lnw: 

on buiIdSl|,WtthuutITunestth^Signature) 
tell application "Hierosofr Entourage" 

-hcfc's where we a random sipjiaturc. thank PiuJ Ucrtowii^ fur iIh’ liclp licn^ 


set randomSigs to every signature whqsr? Include in 
riindoffl is true 

if the length of randoiiiSigE is equal to 1 then 
{*■ this is lo catch the La Giua hug, wherdn you only have one sig set to random, 
oanvdy Uk iTuncsSigThis creates a prohlrm where instead of die not playing 
mcssoi^' you get the tunic of Ihe last tniK' to play tmtil you run iTuno again. 0 
set tbeSignature to the name of the first Item of 
randomstgs 

i f theSignatiite is "'iTunesSig* then 
act theSlgnature to " - 
itunes isiL* t playing right now" 
end if 
end if 

if the length of randomSigs is greater than I then 
-more than one signaiLm: in die random Ibi 

act theSignature to eome item of randoniSigs 
-This gives you the nunicrkiil ID of die M-iccicd sig 
set theSIgnature to the content of theSlgnature 
-this gives you the text content of the selected sig 
else 

^h - oh, no random sigs 

set theSignature to "- - 
I runes isn't playing right now" 
end if 
end tell 

return theSignature 
end buHdSigWithoutlTunes 

So now', w'e have to de;tl whth crciiting a signature llmi lias 
nothing to do witli n'unes, since it isn't playing anything. We tell 
Entourage ic> cRttiie a list of signature.s that have the random Hag set 
Lo true. Next we avoid the hi Gnia hug, by checking to sex: if the 
iiumlK^r of items in this list is 1. if ti is, wc sci ‘theSignature’ to the 
name of that single item. If that name is “iTunesSig" then we don’t 
want to use poteniially ok! track infonnation, so we change tlie 
cx>nlends of theSignature' to "“\r iTunes isnt playing riglit now'", 
we return iheSigmirum, and we'rc' dtaie wilh the handler, 

[f the numixT of iLems in ra ndoinSigs is greater tin an one, 
ilicn w'e set theSignature' lo some item’ of TandomSigs, 
(AppleScriptese for *gimme a nindom selecikm from that list'). 
This gives us the index numIxT for a random selection from that 
list We then reset theSignature' to the contenis of tlie signature 
that the index points to. Once that i>s finished, w'e return 


- w - 



Now serving Cocoa® 
just the way you want it. 

Training for Mac OS X doesn’t have to be the same old flavor. 
Reserve your seat in a class at our scenic lodge location, 
or have experts come to you for Extreme Mentoring. 
Two weeks of on-site instruclion and collaboration, 
customized to the requirements of your project. 
Book now for 2003. See why we’re different. 


BiO 

nerD 

rancH 

Intensive Classes for programmers 
WWW. bignerdranch .com 
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iheSignaturc' and weVe done^ Tht^ ‘else’ statement la txnly there 
if the number of random signatures is no! 1 and not greater than 

so all that's left is 0 random signatures. In that rase, we set 
‘theSignaiure* lo \r iTiines isn't playing right now", we return 
'theSignature' and we're done with the handler 

However while we now Itave a signatuR' ready to go, even 
thoiigli iTttnes Isn't playing, we still haven't told Entotinige to 
actually change the signaiitre. Well, we ct>yld just [Xit that ecxle into 
the UnldSigWithoutriunesO, Ixit why duplic'ine code? As w^e saw 
earlier, we already liave that code built and running, why nut use 
it? After all, code reuse is 'a gtxxl thing'. So that's what we do. if we 
Review' two of tile last lines in the main btxly of the program: 

set rtveNowSig to btiildSigWithoutiTynestt-tieNcwSlgJ tlic 
honclk-r titJi hyads a sig wiilwHJi ifimcs runjiing 

buildSig(theMevSig) -upiUtt: the sig to sotne rjipgom sig erratnJ by xht 
pit;vknui Itrw: 

We see that the first line is w^hat calls the 
buildSigWifhoiiti fullest), and ,sets llieNewSig' to the rerunied value. 
The tiext line calls our previously disaiased buildSigO handler, and 
passes it 'tlieNewSig'. Tliai handler is w^fuit creates the new sig in 
iTunes. So we don’t have to re-enter the same code* ft’s a nice way 
to keep your t:ixJe listings shorter. Tlie next line closes up the 
.'aatement that checked to ,see if ffunes w^is even rutuiing, and that s 
the end of the main program, and vve^re rbne* you'll want to save 
this as a compiletl script, not as an af3plit:alion* You on save it 
anywhere, but f prefer to s^ive it in '-/nociiments/Micrtxstfi User 
r>ata/flntoiirage Script Menu Ikans/, sf> 1 on am it manually from 
llic Rniourage .Script menu if need lx*. 


schedule is going to lx* oeaiing to an acrount. I chase iny rnac.cx>m 
acciHint, as I mostly use tlM for fxisona! email. 7he setup for tliai 
Is preiiy easy as well. 'ITiLs account li;ip|Xais to lx an IMAF account, 
but the seiuf) for POP accounts is the s^ime. Go to the T<x>ls‘ menu, 
and select 'Accounts'* In the list of accounts, double-ciick tlie 
account you want this signature to altacii to, and seled the <3plioas 
tab* Tlien in tlx signaiune pull down, pick the appropriate entry for 
the iTunes Signature, nonmily TTunesSig'* My setup is seen Ixlow: 


Edir Accduni 


AcuiyRt Sitiengt f | Mvwc«(i ^ 


MciuflD Optwna _ 

Ovfjum niQfiJJurf , 


jwiuwua ivjdtM 


3 


Servef 0|3tiDnb *____ _ - 
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T/c^-ntrt^ 

i&nan^ir* ■ * 
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Setting Up Entourage 

So now' we have a serijii, how' do we get Kntourage tt> use 
this liit of schpl w^e have created? Well, first you1l want to create 
a schedule so it can run regularly, fve been running it every 
minute for about five months m)w withoui a problem, 71ie 
schedtilc setup is pretty simple, as we can see below: 


Edit Schtdulft 


il^rw i(TWM«9rt^ 


When 


0 ^ AddOccuirence J|£ OKorreM^' 


^ Ewy 1 1 Mimus 

Qohiy iTcsniweltd 

_Aftion 

Adtf Actum 

X, Hemovt Aaum 

Urn A^itAcn^t 


PUhtp 

fg! gayaaftbecM Q Ch** Q fhitftn la pn. twu iCH* 

S EiiAblcd 

f Cancel 3 f 04t > 


Setup for iTunes Script Schedule 


You give it a name, set it to lx a rejxaliog .sctxdule, and set 
the action to lx Run AppleScript' and point it at the 'sigfromiTurxs' 
.script. Make sure die 'Enablecf checklxix Is chec'ked, click 'OK' and 
your schedule is set. The next step is to attach the signaluie that this 


Once thiit's done, click 'OK', and you’re all set to wow your 
friends with your vast collection of legal MP3s* 

Conclusion 

Well, it's nor a terribly .serious or ncawork-relaled u*se for 
AppleScript, but then again, you are supposed to have some fim 
with your Mac eveiy' once in a while. Otherwise, you may as well 
use Wintlows, Also, I have dune some testing, and this should 
work on iTunes 3 as well as 2.X, but if it doesn't, by all means, 
feel free to fk it. Finally, licre are some URLs that can help you 
with thus, or any other AppieScripting projects you may have: 

• http://www.apple*com/applescrlpty 

Apple's AppleScript site, and a great jumping off point* 

• http://wvwv.latenitesw.com/ 

The makers of Script Debugger, my, and many otlicr 
scTiptef s tool of choice. 

• http://www.applescriptsourcebook.com/ 

Hill Clieeseman’s fantastic' AppleScript site 

• http://www,orielly,com/ 

Fublisliers of “AppleScript in a Nutsheir 

• htlp://www.peachprt*com/ 

Publishers of “AppleScript for Applications: Visual Quickstart 
Guide’* 
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EDITING 

DROPSCRIPT 

DROPLETS 

EASILY 


By Ixirry Taylor 


An Editor to Create DropScript Droplets 


Making the DropScript experience more 
like the MacPerl experience 


A I^ORERM 

1 love MacPert* 1 even wrote tin article for Maclech extolling 
its virtyes (Sept. 2000). MacPerl is a Mac port of Perl, inliuilly a 
UNIX st^ripliiig language, lietng LiNIX based, OS X comes with a 
Perl iniplemeniation and tfiere have been many excellent 
MacTech articles recently touting its uses. Rich Morin has a 
whole series (Aug. Sepi, 2002, Jan. 2003); Jeff elites (April 
2000X Paul Ainmann (June 2002) and Joe Zobkiw (Sept. 2002) 
liave aaicles as well. By the time this appears, there will 
iindoiihtedly fie more. The basic idea is simple. Write a Peil 
script to do something useful, make the file executable, set it to 
lx? opened by the Terminal application and you're ready to go. 
Double click on the file and the Perl script runs, ju.st like simple 
drr^piets in MacPerl. 

However many scripls [>RK:ess files or folders, lltc great 
thing alxuu a MacPerl droplet Ls that you can drag the 
files/folders onto it and get the path names of the drop|>ed 
collection in the @ABGV amiy. My article depended on this 
liehavior and I really miss it in OS X. 

'rhen Wilfredo Sanchez wrote a program callcxl DropScript to 
make drtiplets. He wrote a nice MiicTeeh ariidc (Aug. 2001) 
alxjut it. Additional information can lx? found in the README file 
in the examples folder diat etmies with the DropScript distribtition, 
DropScript c'un make droplets to nin Bourne shell scriiXs, the C'ase 
Sanchez concentrates on, or Perl scripts, tcl scripts, I^hon scripts 
.,, , Just set tile slicbang line correctly and ytJiiTe off. 

My main gri|X* with DropScript comes from my bad haiiit 
of coding quickly. Every lime I changed the code 1 had to 
re-run the file through DropScript and, if I forgot to delete ifie 
old droplet, I was nterely informed that the droplet existed and 
I had to go buck, delete the old droplet and run my file through 
DropScript yet again. Not an at)pealing scenario! Using MacPerl 
you just opened the droplet in MacPerl, typed in your new 
code, saved it and the behavior of the droplet reflected your 
changes immediately. 


A .second mut is die end-of-line problem. DropScrif)! 
expects the strripLs drt>pped on it to have UNTX end-oMines, \n, 
whereas it is notoriously easy to be using a file with Mac 
end-of-lines, \r. TextEdit or BBEdit will save files as TEXT wiih 
UNIX eol's once you have such a file and BBEdit will even 
convert an old Mac file for you, so the issue is not serious us long 
as you remember to do the swiiiii. 

A SoLimoN 

Reading Sanchez’s article more curefully I realized that the.se 
droplets were applic'ations and applications are folders under OS 
X. You can see llte folder by opiion-ciickmg the app and 
selecting Show Package Contents from the contextual menu. 
Your application opens as a folder which contains a single folder 
called Contents, and DropScript copies the scripi to the file 
/Contents/Resources/script. Experijneniation showed that I could 
edit this file directly and run die new^ code without going through 
DropScript again and die eol-problem ttxik care of tLself. 

Rveniually it occurred to me that I could write a 
droplet^Perf-scripr to avoid the option-click process, hence 
Droplet Editor, the fixais of this arllde. Drop a droplet onto Droplet 
Editor ;ind the scripi file is opened. Droplet Editor also supports 
jnaking a new droplet. 

First Steps 

Since Droplet Editor itself Ls a droplet, wt- are going to begin 
with a minimal version of the code and then use it to finish the 
whole project. Step one is to acquire DropScript from 

www.apple.coTTi/downloads/macosx/unix_opGn_source/dropscript.html 

iind put the application somew^here- if needs no installer. I put 
mine in a folder DropScript inside my Applications folder, but it 
dwsn't have to go there. Make a copy of tlie prt>gnini, rename 
it Droplet Editor and put it anywhere you have read/write 
permissions. Now option-click Droplet Editor and select Show 
Package Contents from the contextual menu. Open the 
Contents folder and liieii the Resources folder. Open the file 
script in BBEdit or TextEdit by dragging it to tlie dtKk onto one 
of these apps. 


The author is a research matheinaLiciiin arui professor who spends loo [luidi time hMjiirig artjund with this sort of thing. More stuff at 
<www.nd.edu/-raylor>. 
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Odert* the axle currently in the file and enter the 
following axle. 

If! /ii^r/binVperl 

strict; 

mmmmm Fixf*rf paths 

rayt$editoE path)-" I Appllcatiotis/BBEdit/BBEdit.app ^* 
ray(Seniulator_path}=''/Contentfi/Resources/script **: 

raytSaal: 

f[>r<»ach $aa t^ARGV) I 

ift $aa“^A.app$/ -f $ao.$«Diulator„path) \ 
my($app)“sttbfitr {$aa* rindex($aa.’’/"J+1); 
print^Opening the script for \"$app\'\ \n"; 

$aa“$aa, SeaiEtlator^patij: 
fiyatt^mf'opcn a \"$aditor_patb\ 

I 

I 


If your editor of <‘hoice is located elsewhere, change the 
$editor_path. Save your icxi and close the file. Add Droplet 
Editor Lf> ihe ctock, 'I'rack down and o[)en the Console program, 
usually in /Applications/Utilities/, since messages from droplets 
show up here. Now drag ilic Droplet Editor application onto its 
icon in the dock and your file will pop open in BBEdlt or to 
whatever word processor your Seditor path pthnis. If you drop 
any other droplet onto Droplet Editor the script for that droplet 
opens. If you have errors in tins initial Droplet Editor script, llic 
error messages show up in the Console whndow. Reopen the 
script the hard way and fix the errors. Repeal as needed until 
die script opens. 


C<>MPl.FnNG THE PROJECl 

The rest of the project involves adding bells and wliislles 
to this l>asic code, especially the mechanism to create new 
droplets. We do this by treating the drop of anything that is 
not a droplet as a re{|iiest to make a new droplet^ named 
after the dropped object. If you drop a file or a folder named 
foo which is not a droplet, you get a new droplet, Dropfoo, in 
the same folder as the file or inside the folder. This bit of ihe 
project is handled by a subroutine make_basic_droplet which 
takes iw'o arguments, the folder in whicli to put the new' 
droplet and its name. You can set the extension of ihe 
dropped object to specify wliat sort of script you want as 
indicated below. 

t'irsi add the path to your copy of DropScript to the "Fixed 
paths" list, 

iiiy{Sdropflcripl_patli)="/Appiicatione/DropScrlpt/DropScript .app 


At the lx)llotn of the foreach-loop add the follt>wing two elstfs: 
eUif{ -d Saa) [ 

my {Snaine) =aiibstr (Sea, ri ridex t $aa+1); 
make .baflic_droplet{$Hfl,: 

I 

-f $aa) ( 

ray ($di r)“subiJtr($aa,0,j:index(Saa. '*/'')): 
ray ($iiarae)“suijstr($aa*rindex(Saa, : 

inake_beslc_droplet {$d j r, Snarac) t 

I 
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This finishes the projea except f(;r writing the code for the 
subroutine. Begin with tliree lines. 

sub mbke3osic_dr0plet t 
iayf$dir)^$hirt («_]; 
my ($Ti3iiie)=shlf t ti_) i 

Next we determine the type of script l)eing requested. The 
next four lines extract tiic extension of the dropped tibjcct and 
do some checking. If the evenaial name of the script would 
.start with a period, which would make the resulting droplet 
invisible, we ball 

ny($scrlpt_rype): 

if( $Tiame=^s/(\* ‘)$//] l$ 0 cript_type“$l; J 

else i$script type-'.default *i \ 
if($uame cq "*) ireturn 

Next we want to determine if we recognixe the extension. 
We begin by building a list of extensions we recognize. 
Return to the top of ilie file and just after the ’’Fixed paths" 
add some lines 

Script types 

my {%script_type) : 

Sscript^typol ’ .default* I”"#! /usr/bin/pcrl'': 

$script_typei * .perl' 1 /usr/bin/perP ; 

Sscript_type| * .py * J="#!/uEr/bln/pythoD*'; 

$scripT:_type(' .sh* J="#!/bin/sh'’^ 
iscripT^TvpeP .tci' I"*#!/usr/bin/tclah" ; 

Tltc first line is required; ihc resi are optional. 1 mostly write 
Perl scripts so my ".default" script_type is the Perl shebang line, 
l’>ur J have included exteasions for Bourne shell script.s, ’’.sh", 
Python .scripts, ".py" and tcl stTipis, ".td". If the dropped 
fiJe/folder has a recognized extension, the sitefxing tine in tlie 
new script will be the corresponding 7oscript_type. A 
ntjn-recognked extension, including no extension, defaults to 
".default". You are of course free to add/delete/modify ihese 
entries to suii your needs. A.s an example, if ytm always use the 
-w Hag in Perl you might want to diange the ^lxr^P entry to 
$scrlpt_type{'.perr}="#!/usr/btn/perl -w"; 

Now return lo tlie IxHtom of the rile and add the line 

iff !exiExs($script_typet$BcripL_typol)] 
l$scrlpT_rype-*.default': 1 

w'hicli sets tlie variable Sscriptjype lo cIiIkt ".derault" or the 
droj)]X"d object’s extension jf we recognize it. Then a<ld ten 
more lines whit'fi construd the droplet name and check tliat the 
name isn't in use. If it is we just keep adding a numlx^r to the 
name until we get a name with no conllicls. Tliis prevents 
accidental destruction of files, but if you never make such 
mistakes, skip the nine lines Ix^ginning "iff -d 

my (Saa]=Sdii!. "/Otrup". Sname," ,app"; 
iff -d Saa) I 

prlut''\ri\nThare already is a droplet 
\ "Drop" , $narae, ** \ ■*. \n\n **; 
niyfSnextnfltticJ'*!: 
iiiyfSName)”$uairic; 
whileC -d $aa) I 

$EaaLe"$Haiae. $uextnajie: 


$aa“$dir. ” /Drop'' . $iiai]ie . *' .app* : $nextname++ ; 

I 

1 


DropScripl is cxfiecting a file to copy into the ugw 
droplet, so next we produce the reciuired file. If there already 
Is a script file then we read it into the #script array and 
change any Mac eol's to UNIX ones, avoiding any 
eol-probicms. If there ts not already a script file w'e just set 
©script to put in a couple of UNIX eol’s. llien we write a file, 
Soutfile, which DropScript will copy into the droplcL If you 
already had a script with a shebang line, you now stan with 
two. We do this because Apple does nut always put programs 
like Perl in their standard places so if you are porting a Perl 
script, its shcljang line is probably wrong. However, it may 
iiave flags you will need to copy so it's nice to see what the 
old one was. 


my (Soutfile) ^$d i r." / “ . $najie. $sc rlpt^type: 

my(#script]; 

if( -f $outf±le) I 

open (IN, $oiit file) or dle($!){ 

0script=<IH>: 

close(INI; 

n]y{$Kx)i 

foreadi Sxx f^script) I $ 3 U£^a/\r/\ii/g; I 

I 

else f push (#script, "\n\n’') ; 1 

Soutf 1 le=$dir .**/**. $ttaaG. * .default*: 

open(OUT.">$outfile*J or dletSt): 

pr int OUT $sctipt_typef $BCElpt_typef,'■\n’*: 

print OtiT @sct;ipt: 

closefOUT )1 

undef(#£cripL); 


'Hie next step tells DropScript to make the droplet and 
announces the birth. 


Eyfite«(*open a \’'$iiropEcrlpt_pat KV" \"SoutfHe\""): 
pr int"\n\nCr«atinR new drop leu V^Drop" .$nanie. 

The final bit of ctxie is designed lt> overcome a ihreatling 
problem. DropScript re(|uests tluU the file $outfile !x! copied to the 
rile $AA, but the copy may not take platv immediately. We want 
to delete the file Soutfile from wliielj we are copying, iiut we 
shouldn’t do this until after die copy is rinishetl. The einpty 
while-kK>ps just wail until various files/folders art' created and 
tile $AA file !ias non-zero length. Then we wait some more until 
$AA and Soutfile are the same, which we check using the UNDC 
diff command. Tlie >/dev/null bit is UNIX for "lhn>w away the 
ran put of the dfff command" (which is a list of the differences >. 
Finally we delete $outfi!e. 


while{ t -d [;l 

my ($AA)=$aa, $eiiiuliiior_path: 
whilaC 1 -f "$AA") j ;1 

(nytSBEl^Saa.*/Contents/Info, pi tst" : 
whlU( i -f I :l 

whlloC "SM“) I ;| 

while (system("diff \''$AA\" \"$outfile\" > /dav/null')/25f» 
!“&) I;1 

unilnk($outfils); 
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We end by caponing the script ot our new drcjplet and closing the 
bmcc for our subroutine. 

sysLem{"open -a \'*$ed.ltor_patK\" 

i 


SoMii Final Remarks 

Drop Script-droplets have two annoying features. One bit of 
annoyance Is that print c:ommands go to the Console progratn 
which may be hidden or may not even Ix^ open, so you1l think 
there was no output. To fix this, acki the line 

syetetn{" open \" / Appti nations /Utlii /Corieol e. app \; 

Up near the start of your scripts. Other programs are also writing 
tt) this window^ so your output may get sandwiched between 
Ollier output which is wdiy I have the \n\n's around my text to 
make it easier to find. 

Ttie other annoyance is that ihe working director^’ of 
your droplet is root, whereas MaePert sets it to the folder 
containing the droplet. If your code has path names 
beginning with these droplets proliatily will not wwk. 
Other scripts may try to write files to the root directory which 
often fails and is never wdiere you are looking for them 
anyway. Calling pwd in your code probalily means it wilt 
break as well. The solution is lo gel ilie folder containing the 
droplet, and then you can do a chdir. The Perl variable $0 
contains the patli lo the code file, hut tmder OS X this file is 
several folders deep inside the droplet, which is a folder. The 
following code snippet yields the folder containing the 
droplet (wathoui ihe final V"). 

iiiy(Sapp)=$0: 

$app=substrt$3pp.O. rindex($app. "/Contents")} j 
Sapp=substr tSapp.O. r indc?x(Sapp."/")) \ 

Initially 1 ended this article with a list of features enjoyed by 
MacPerl droplets that I wotild tike to see in DropScript dro[>lets. 
An anonymous editor saw this version and pointed out that 
many of these features had been tarlK>ni>ced in recent release.s 
of MacPerl. A bit of experimentation revealed that if you have 
chased doW'U and installed both a version of Perl newer than the 
Apple-included version, and ihe carhoni7,ed MacPerl modules, 
tlien you am have many of the MacPerl features such as Ask, 
Answer, Pick, etc. in your new droplets. "Iliese installations are 
not for the faint-of-hearl, but if you gtJogle around you can dig 
up the necessary files and lots of chit-c'hat on 
problems/solution.s. 

Happy scripting! 
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2. Cut Corners 


For developers under pressure to manage source code and do more in less time, 


Perforce's Fast Software Configuration Management System is the must-have tool. " 


With rival SCM systems, the only way to 
quicken the pace is to cut comers - btit in the 
long run you pay the price with missed 
deadlines, uncertain contents, buggy releases 
and no way back to previous builds. 

With Perforce, the fast way is always the 
right way. Install it fast, learn It fast, execute 
operations fast With other SCM systems, 
developers face an unpleasant choice: 
do it the right way or do It the fast way. 

Perforce's speed and feltabillty mean fast is right. 
See how Perforce compares with other 
leading SCM systems at 
http://www* perforce .com/perforce/reviews*htm I 


Ran at futt speed even with hundreds of users 
and niWions offites. At the core of Perforce lies 
a relational database with well-keyed tables, 
so simple operations can be accomplished in 
near* 2 ero time* Larger operations (like labeling 
a release and branchirtgl are translated into 
keyed data access, giving Perforce the scalabiniy 
that big projects require. 

WbrA anywhere. Perforce is efficient over high- 
latency networks such as WANs, the Internet and 
even Jow-speed dial-up connections. Requiring 
only TCP/I R Perforce makes use of a we 11-tuned 
streaming message prolocot for synchronising 
client workspace with server repository contents. 


Develop and rnaintam multiple codelines. 
Perforce Inter file Brandi Eng'^ lets you merge 
new features and apply fixes between code lines. 
Smart metadata keeps track of your evolving 
projects even while they develop in parallel. 

7ru/y cross platform. Perforce runs on more lhan 
50 operating systems, including Windows and 
nearly every UNIX' variation, from Linux' and 
Mac OS X to AS/400 and more* 

Integrate with leading IDEs and defect trackers: 
Visual Studio.NET’, Visual C-h-% Visual Basic'', 

JBuilder , CodeWarrior", TeamTrack^, Bugzilla% 
COntrofCenter*, DevTracIc" packages, and more. 


Perforce 

SOFTWAIIE 

Fast Software Configuration Management www.perforce.cam 


Download your free 2-user, non-expiring, full-featured copy now from www.perforce.com 
Free (and friendly) technical support is on hand to answer any and all evaluation questions. 


Al) hwitfi we or nBgietensd indern»04oT iheirrespecwe cwr^ri 
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RON FROM SANTA FE You 
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I see you Wil come down to 
NdoK Rw you FMdayniobi wGf34l 


LAWN CARE? NIy iKJSband got lajry 
and fiired you lo itkjw our lawn, 
Insiead you landscaped my erotic 
fantasies Iti ways I have never tmag- 
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GORGEOUS. WITTY, BORN TO 
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warm conversation 11 you're (all. 
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Pld^^Ale at the bid people hortid 
F^MHekend; Vbi; were a ter6bf.^’';:\ 
^.|nd gulte.undllraclive. bdi::-"' 
jV h^art is obvlou&iy pure fipid; 
My iiirtter would be pefJeciib'' VbLj. 
07867. ^ 


ARE YOU HONEST. JiiKikiJOftTe. 
.BLtfcesanil. tmaticifliiy'sfecerovirrteiiiv 
gom^ worUt travcIecL dbJtuuKi. pre 

al^« M. playliA. paa- 


MONKEY TRAINER, Seekiftp 
woman to train my monkey 
Seriously, his mrm is Murphy and 
he is a 3 year old chimpehiree He 
likes pop tans and nkia people. 
Pius, you and 1 will-have so* 
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(npifi erp^l^dr}. iDvd of naltin. 
mevereni; hgtror. ,«6T7i2 ■ 


recently PAR^LBO, lookitifl 

a wiw ma on tim 

na636/ 


We're Easier. 

Create anything from prototypes to full professional applications. Just drag and drop interface 
elements while REALbasic handles the details. You concentrate on what makes your stuff great 
your ideas! REALbasic creates native compiled applications for Macintosh, Mac OS X and Windows 
without platform-specific adjustments. Its the powerful, easy-to-use tool for creating your own 
software. Each version of your software looks and works just as it should in each environment. 

Complex problems shouidn't require complex solutions, The answer is REALbasic 5. 


3 REALbasicS 


www.re3lbasic.corn Download a free demo. Come see us at the Apple WWDC! 

Now dvaitable at Appip Store. CompUSA and Fiy^ Elocuonia 

















